Skip to main content
WEBHOOK
CARDHOLDER_CREATED
{
  "event":       "CARDHOLDER_CREATED",
  "eventId":     "evt_01HXY123456ABCDEF",
  "businessId":  "BUS1A2B3C4D5E6F",
  "environment": "LIVE",
  "timestamp":   "2026-05-22T10:00:00Z",
  "data": {
    "cardholderId": "chl_01HXYZ1234ABCDEF5678",
    "firstName":    "Jane",
    "lastName":     "Doe",
    "email":        "jane.doe@example.com",
    "status":       "ACTIVE",
    "kycStatus":    "PENDING",
    "externalId":   "my-user-id-789"
  }
}

{}

Documentation Index

Fetch the complete documentation index at: https://docs.fyatu.com/llms.txt

Use this file to discover all available pages before exploring further.

Fires immediately after a new cardholder is created via POST /cardholders. KYC verification is triggered automatically — subscribe to CARDHOLDER_KYC_APPROVED or CARDHOLDER_KYC_REJECTED to be notified when verification completes.

​
Event Type

CARDHOLDER_CREATED

​
Payload

{
  "event":       "CARDHOLDER_CREATED",
  "eventId":     "evt_01HXY123456ABCDEF",
  "businessId":  "BUS1A2B3C4D5E6F",
  "environment": "LIVE",
  "timestamp":   "2026-05-22T10:00:00Z",
  "data": {
    "cardholderId": "chl_01HXYZ1234ABCDEF5678",
    "firstName":    "Jane",
    "lastName":     "Doe",
    "email":        "jane.doe@example.com",
    "status":       "ACTIVE",
    "kycStatus":    "PENDING",
    "externalId":   "my-user-id-789"
  }
}

​
Payload Fields

FieldTypeDescription
cardholderIdstringThe newly created cardholder ID
firstNamestringCardholder first name
lastNamestringCardholder last name
emailstringCardholder email address
statusstringAlways ACTIVE at creation
kycStatusstringAlways PENDING at creation
externalIdstring or nullYour internal user ID, if provided
For the full event group documentation see Cardholder Events. 
{
  "event":       "CARDHOLDER_CREATED",
  "eventId":     "evt_01HXY123456ABCDEF",
  "businessId":  "BUS1A2B3C4D5E6F",
  "environment": "LIVE",
  "timestamp":   "2026-05-22T10:00:00Z",
  "data": {
    "cardholderId": "chl_01HXYZ1234ABCDEF5678",
    "firstName":    "Jane",
    "lastName":     "Doe",
    "email":        "jane.doe@example.com",
    "status":       "ACTIVE",
    "kycStatus":    "PENDING",
    "externalId":   "my-user-id-789"
  }
}

{}

Authorizations

​
Authorization
string
header
required

API key from the FYATU CaaS portal. Pass as Authorization: Bearer <key>.

Body

application/json
​
event
string
Example:

"CARDHOLDER_CREATED"

​
eventId
string
​
businessId
string
​
environment
enum<string>
Available options:
LIVE,
SANDBOX
​
timestamp
string<date-time>
​
data
object

Response

200

Acknowledge the event.