Sent when a new card is provisioned for a customer. Carries a trimmed card object. All deliveries share the common envelope (eventId, eventName, timestamp, programId, sandbox, customerId, clientReference).

card fields

nickName and limitGroupId are included only when set.
FieldTypeNotes
cardIdstringThe card identifier.
accountIdstringAccount the card is attached to.
maskedPanstringMasked card number.
cardTypestringe.g. VIRTUAL, PHYSICAL.
currencystringCard currency.
statusstringACTIVE, CREATED, BLOCKED, CANCELLED, EXPIRED.
nickNamestringOptional. Customer-set label.
limitGroupIdstringOptional. Spend-limit group.

Example

{
  "eventId": "c9f1…",
  "eventName": "NEW_CARD_ADDED",
  "timestamp": "2026-06-23T12:34:56.789Z",
  "programId": "yourprogram",
  "sandbox": false,
  "customerId": "cust_123",
  "card": {
    "cardId": "card_789",
    "accountId": "acc_456",
    "maskedPan": "528211******1234",
    "cardType": "VIRTUAL",
    "currency": "EUR",
    "status": "CREATED",
    "nickName": "Travel card",
    "limitGroupId": "lg_1"
  }
}