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…

Issue a virtual card. Add the cardholder to your account through the dashboard, then call Create a card with the funding account, the cardholder's userId, the kind (debit or credit), and any spending controls. The card is usable immediately on creation.

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@.

cardSpendManagementState

object | null

Optional spend-management state to apply when the card is created
(single-use auto-cancel, agentic-agent management).

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