Skip to main content
POST
Create cardholder

Authorizations

Api-Key
string
header
required

Partner API key. Must carry the cards permission.

Headers

Api-Version
string
default:2026-09.1
required

The API version this request targets. 2026-09.1. See Versioning.

Pattern: ^\d{4}-\d{2}\.\d+$

Path Parameters

businessId
string
required

Your business customer, cus_…, enabled for cards.

Body

application/json
firstName
string
required

Non-blank.

lastName
string
required

Non-blank.

email
string
required

Valid email. Must not already be an Endl account or another business's cardholder.

phoneCountryCode
string

Digits — "1". Required with phoneNumber.

phoneNumber
string

Digits, unique across cardholders. Required with phoneCountryCode.

Response

The cardholder. Returned directly — no envelope.

cardholderId
string

cus_…. Use it to issue cards.

businessId
string

The business.

firstName
string

As stored.

lastName
string

As stored.

email
string

As stored.

status
enum<string>

Cardholder state.

Available options:
active,
pending,
rejected,
canceled