Create Cardholder

POST /api/v2/accounts/{account_uuid}/cardholders

Request body

Field	Type	Required	Description
cardOwnerId	string	Yes	Your unique id (a-z, A-Z, 0-9, -)
first_name	string	Yes	1–255 chars
last_name	string	Yes	1–255 chars
email	string	Yes	Unique within company
phone	string	No	Max 50 chars

curl -s -X POST "https://api.4pay.cc/api/v2/accounts/ACCOUNT_UUID/cardholders" \
  -H "X-API-Token: YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "cardOwnerId": "owner-12345",
    "first_name": "John",
    "last_name": "Doe",
    "email": "john.doe@example.com",
    "phone": "+1-202-555-0147"
  }'

Response

201 — body shape is provider-normalized; typically echoes cardholder fields.