v1

latestOpenAPI 3.0.2EULA2026-07-143221521.2 MB

Cards

Create a card

Add a new customer card.

⚠️ Endpoint is available only in the Enterprise interface.

What happens when a card is created

A card record is created and its server-generated card_id is returned.
The card is linked to the supplied customer_id.
A marketing-automation "assign card" event is triggered.

Related operations

POST /cards/batch - create multiple cards in a single request.
POST /cards/actions/assign-free-card - assign an existing free card from a pre-imported pool.
PUT /cards/{card_id} - update an existing card.

post/cards

Headers

Accept-Languagestring

The unique ID of the language code by ISO 639-1.

Request body

Example request

{
  "card": {
    "card_id": "81eaeea13b8984a169c490a325",
    "customer_id": "8ea2591121e636086a4a9c0992",
    "card_type_id": "8bed991c68a470e7aaeffbf048",
    "card_number": "1000000000016",
    "secondary_card_number": "AXNFUAIOHFDSNKA",
    "valid_from": "2021-04-14 00:00:00",
    "valid_to": "2059-07-05 00:00:00",
    "last_change": "2019-07-15 17:26:34",
    "state": 1
  }
}

Response

Created

Example response

{
  "data": {
    "card_id": "81a94c48474bc45c03d41f7016"
  }
}