Card
Create card
Create a new card with a required card_account_id parameter.
Body Parameters
authorized_user_entity_id
stringRequiredThe ID of the person entity authorized to use this card
card_account_id
stringRequiredThe ID of the card account to create the card under
card_authorization_policy_id
stringOptionalOptional card authorization policy ID for the card
card_template_id
stringOptionalOptional card template ID to use for the card. The template must belong to the card account's card program
description
stringOptionalOptional description for the card
encrypted_pin
stringOptionalDebit 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
integerOptionalOptional expiration month (1-12)
expiration_year
integerOptionalOptional expiration year (4-digit year, e.g. 2025)
generate_pin
booleanOptionalDebit 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
objectOptionalShipping address and contact information for physical card delivery. Required when type is physical See Shipping details sub-object.
status
stringOptionalOptional initial status for the card
type
stringRequiredThe form factor of the card. Possible values: virtual, physical