Card

Create card

POST/issuing/cards

Create a new card with a required card_account_id parameter.

Body Parameters

authorized_user_entity_id

stringRequired

The ID of the person entity authorized to use this card

card_account_id

stringRequired

The ID of the card account to create the card under

card_authorization_policy_id

stringOptional

Optional card authorization policy ID for the card

card_template_id

stringOptional

Optional card template ID to use for the card. The template must belong to the card account's card program

description

stringOptional

Optional description for the card

encrypted_pin

stringOptional

Debit card programs only. Base64-encoded encrypted PIN. Omit to create the card without a PIN; the card's pin_status is unset, and transactions that require a PIN decline with pin_not_set until you set one with PATCH /issuing/cards/\{card_id\}/pin. To have Column choose the PIN instead, omit this and pass generate_pin. Treat an encrypted PIN like the PIN itself: never log, store, or reuse it.

expiration_month

integerOptional

Optional expiration month (1-12)

expiration_year

integerOptional

Optional expiration year (4-digit year, e.g. 2025)

generate_pin

booleanOptional

Debit card programs with PIN reveal enabled only. Pass true to have Column set a random 4-digit PIN on the card instead of providing encrypted_pin, which must then be omitted. The card's pin_status is set. The PIN is never returned in the response; the cardholder learns it through PIN reveal.

shipping_details

objectOptional

Shipping address and contact information for physical card delivery. Required when type is physical See Shipping details sub-object.

status

stringOptional

Optional initial status for the card

type

stringRequired

The form factor of the card. Possible values: virtual, physical