Skip to main content
POST
Create a card for a user

Authorizations

Api-Key
string
header
required

Path Parameters

userId
string<uuid>
required

Id of the user to create a card for

Body

application/json

Card to create

type
enum<string>
required
Available options:
physical,
virtual
status
enum<string>

The initial status of the card

Available options:
notActivated,
active,
locked,
canceled
limit
object

The initial limit of the card, in cents, - this can be changed later

configuration
object

An object for configuring the card

shipping
object

Shipping address for physical cards. When a bulk shipping group ID is provided, this address is can be used for the final delivery stage from the shipping group delivery address to the end recipient.

bulkShippingGroupId
string<uuid>

Unique identifier for a shipping group that consolidates multiple physical cards for delivery to a single address. Required for bulk shipping operations and must be obtained from the /shipping-groups endpoint.

billing
object

The address that will serve as the billing address for the card. Defaults to shipping address/team address if not explicitly provided

taxId
string

Optional tax identification number for the cardholder, used only for physical cards to improve customs acceptance on international orders. It is not required, is never persisted, and is ignored for virtual cards.

Required string length: 1 - 32

Response

Successful operation

id
string<uuid>
required
companyId
string<uuid>
required
userId
string<uuid>
required
type
enum<string>
required
Available options:
physical,
virtual
status
enum<string>
required
Available options:
notActivated,
active,
locked,
canceled
last4
string
required
expirationMonth
string
required
expirationYear
string
required
limit
object
tokenWallets
string[]

The name of the wallet that the tokenized card was added to

createdAt
string<date-time>

When the card was created

updatedAt
string<date-time>

When the card was last updated