---
title: "Create a Card"
method: POST
path: "/cards"
---

# Create a Card

`POST /cards`

## Request body

- CreateACardParameters
  - `account_id` string, required — The Account the card should belong to.
  - `billing_address` object — The card's billing address.
    - `city` string, required — The city of the billing address.
    - `line1` string, required — The first line of the billing address.
    - `line2` string — The second line of the billing address.
    - `postal_code` string, required — The postal code of the billing address.
    - `state` string, required — The US state of the billing address.
  - `description` string — The description you choose to give the card.
  - `digital_wallet` object — The contact information used in the two-factor steps for digital wallet card creation. To add the card to a digital wallet, you may supply an email or phone number with this request. Otherwise, subscribe and then action a Real Time Decision with the category `digital_wallet_token_requested` or `digital_wallet_authentication_requested`.
    - `digital_card_profile_id` string — The digital card profile assigned to this digital card.
    - `email` string, email — An email address that can be used to contact and verify the cardholder via one-time passcode over email.
    - `phone` string — A phone number that can be used to contact and verify the cardholder via one-time passcode over SMS.
  - `entity_id` string — The Entity the card belongs to. You only need to supply this in rare situations when the card is not for the Account holder.

## Response `200`

Card

- Card — Cards are commercial credit cards. They'll immediately work for online purchases after you create them. All cards maintain a credit limit of 100% of the Account’s available balance at the time of transaction. Funds are deducted from the Account upon transaction settlement.
  - `account_id` string, required — The identifier for the account this card belongs to.
  - `billing_address` object, required — The Card's billing address.
    - `city` string, nullable, required — The city of the billing address.
    - `line1` string, nullable, required — The first line of the billing address.
    - `line2` string, nullable, required — The second line of the billing address.
    - `postal_code` string, nullable, required — The postal code of the billing address.
    - `state` string, nullable, required — The US state of the billing address.
  - `created_at` string, date-time, required — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the Card was created.
  - `description` string, nullable, required — The card's description for display purposes.
  - `digital_wallet` object, nullable, required — The contact information used in the two-factor steps for digital wallet card creation. At least one field must be present to complete the digital wallet steps.
    - `digital_card_profile_id` string, nullable, required — The digital card profile assigned to this digital card. Card profiles may also be assigned at the program level.
    - `email` string, nullable, required — An email address that can be used to verify the cardholder via one-time passcode over email.
    - `phone` string, nullable, required — A phone number that can be used to verify the cardholder via one-time passcode over SMS.
  - `entity_id` string, nullable, required — The identifier for the entity associated with this card.
  - `expiration_month` integer, required — The month the card expires in M format (e.g., August is 8).
  - `expiration_year` integer, required — The year the card expires in YYYY format (e.g., 2025).
  - `id` string, required — The card identifier.
  - `idempotency_key` string, nullable, required — The idempotency key you chose for this object. This value is unique across Increase and is used to ensure that a request is only processed once. Learn more about [idempotency](https://increase.com/documentation/idempotency-keys).
  - `last4` string, required — The last 4 digits of the Card's Primary Account Number.
  - `status` 'active' | 'disabled' | 'canceled', required — This indicates if payments can be made with the card.
  - `type` 'card', required — A constant representing the object's type. For this resource it will always be `card`.

## Other responses

- `4XX` — Error
- `5XX` — Error

---

[API](https://skmtc.dev/increase/apis/increase-api.md) · [All operations](https://skmtc.dev/increase/apis/increase-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/increase/increase-api/revisions/83b14e7fc19f/schema)