Skip to main content
POST
Add a 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

The enrolled business (cus_).

Example:

"cus_1Xb7cV4bN7mQ0wE3rT5y"

Body

application/json
firstName
string
required

First name.

lastName
string
required

Last name.

email
string<email>
required

The employee's email. It must not already belong to an Endl customer, including your own customers and removed cardholders.

phoneCountryCode
string

Send together with phoneNumber.

phoneNumber
string

Send together with phoneCountryCode.

Response

The cardholder.

Fields without a value are left out.

cardholderId
string

The cardholder (cus_).

Example:

"cus_8Qw2mZ4pL7nR1tY6vB3x"

businessId
string

Their business (cus_).

Example:

"cus_1Xb7cV4bN7mQ0wE3rT5y"

firstName
string
lastName
string
email
string
status
enum<string>

pending — under review. active — approved; cards can be issued. rejected — not approved. canceled — removed; their cards are canceled. locked is reserved and not returned today.

Available options:
pending,
active,
rejected,
locked,
canceled