# Create card

**POST** `/issuing/cards`

Create a new card with a required `card_account_id` parameter.

### Body Parameters

- `authorized_user_entity_id` `string` _(required)_ — The ID of the person entity authorized to use this card
- `card_account_id` `string` _(required)_ — The ID of the card account to create the card under
- `card_authorization_policy_id` `string` — Optional card authorization policy ID for the card
- `card_template_id` `string` — Optional card template ID to use for the card. The template must belong to the card account's card program
- `description` `string` — Optional description for the card
- `encrypted_pin` `string` — 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` `integer` — Optional expiration month (1-12)
- `expiration_year` `integer` — Optional expiration year (4-digit year, e.g. 2025)
- `generate_pin` `boolean` — 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` `object` — Shipping address and contact information for physical card delivery. Required when type is physical See [Shipping details sub-object](/api/card/shipping-details-sub-object).
- `status` `string` — Optional initial status for the card
- `type` `string` _(required)_ — The form factor of the card. Possible values: `virtual`, `physical`

**Request**

```shell
curl 'https://api.column.com/issuing/cards' \
  -XPOST \
  -u :<YOUR API KEY> \
  -H 'Content-Type: application/json' \
  -d '{
  "authorized_user_entity_id": "<authorized_user_entity_id>",
  "card_account_id": "<card_account_id>",
  "type": "physical",
  "card_authorization_policy_id": "<card_authorization_policy_id>",
  "card_template_id": "ctmp_2x8gszy5folpA9s0TOCseE9ABDM",
  "description": "Example description",
  "expiration_month": 12,
  "expiration_year": 2029,
  "status": "active"
}'
```

**Response 200**

```json
{
  "authorized_user_entity_id": "enti_2Q1ctiJm1NypVqCt8UBC8e4xTfH",
  "bin": "41234567",
  "card_account_id": "cacc_2x8gszy5folpA9s0TOCseE9ABDM",
  "card_authorization_policy_id": "caup_2x8gszy5folpA9s0TOCseE9ABDM",
  "card_program_id": "cpgm_2x8gszy5folpA9s0TOCseE9ABDM",
  "card_template_id": "ctmp_2x8gszy5folpA9s0TOCseE9ABDM",
  "created_at": "2024-01-15T09:30:00Z",
  "description": "Marketing team travel card",
  "expiration_month": 12,
  "expiration_year": 2029,
  "id": "card_2x8gszy5folpA9s0TOCseE9ABDM",
  "last_four_digits": "1234",
  "pin_status": "set",
  "platform_id": "plat_2Q1ctiJm1NypVqCt8UBC8e4xTfH",
  "sequence_number": 1,
  "status": "active",
  "type": "physical"
}
```
