Create a card

post

https://api.mercury.com/api/v1/cards

Issue a new virtual card.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

accountId

uuid | null

The account the new card will draw funds from. Required when @kind@ is @debit@; list available account IDs via @GET https://api.mercury.com/api/v1/accounts@ (for debit card creation, the accountId must be associated with a checking account). Optional when @kind@ is @credit@; omit to use your organization's Mercury credit account, or pass the credit accountId from @GET https://api.mercury.com/api/v1/credit@.

kind

string

enum

required

Whether to issue a debit or credit card.

Allowed:

nickname

string | null

Optional user-assigned label for the card.

spendLimit

object | null

Spending controls to apply at issuance.

type

string

enum

required

The type of card to issue.

Allowed:

userId

uuid

required

The user to assign as the cardholder.

Responses

400

Invalid body

Language

Credentials

Bearer

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200