POST
Create a cardholder
Creates a cardholder on the account. For business programs, firstName, lastName, email, and address are required; names use English letters and the combined first + last name can’t exceed 23 characters (it’s what gets embossed on the card). After creating the holder, invite them to a card.

Authorizations

Authorization
string
header
required

The user's id_token from authentication — the ID token, not the access_token. The program and environment come from the token.

Path Parameters

customerId
string
required

The customer's id.

accountId
string
required

The account the card belongs to. A customer can have several accounts; cards are issued against one.

Body

application/json
firstName
string

Conditionally required (business models). English letters; first + last name max 23 chars combined.

lastName
string

Conditionally required (business models).

email
string

Conditionally required (business models).

dateOfBirth
string<date>

Optional. YYYY-MM-DD.

address
object

Conditionally required (business models).

Response

Created

success
boolean
Example:

true

cardholderId
string
message
string
Example:

"Cardholder created successfully"