Skip to main content
POST
Create Card

Authorizations

x-api-key
string
header
required

Your Meow API key, sent in the x-api-key header for authentication.

Headers

x-entity-id
string<uuid>

Optional entity_id to scope requests to a specific entity.

Body

application/json
spending_controls
SpendingControls · object
required

Spend limits for the card. per_transaction_limit is required; period and all-time limits are optional.

nickname
string
required

Display name for the card (max 30 characters).

Required string length: 1 - 30
Pattern: ^[ -~]+$
spending_restriction
CardSpendingRestrictionRequest · object | null

Restrict which merchants can authorize on this card. Omit to allow any merchant up to the spend limit.

allowed_categories
enum<string>[] | null

Restrict the card to these merchant categories.

Available options:
Advertising,
Airlines,
Books and Newspapers,
Car Rental,
Charity,
Clothing,
Electronics,
Entertainment,
Facilities Expenses,
Financial Institutions and Fees,
Fuel,
Furniture,
Government Services,
Grocery,
Ground Transportation,
Insurance,
Legal,
Lodging,
Meals,
Medical,
Office Supplies,
Parking,
Political,
Professional Services,
Recruiting,
Rent,
Restaurants,
Shipping,
Software,
Taxes,
Taxis and Rideshare,
Technology Infrastructure,
Training and Education,
Utilities,
Vehicle Expenses
debit_account
string | null

The account this card draws from, as a cash_account_ id from List Accounts. It must be one of your own open accounts. Omit to use the account this entity issues cards from by default.

Example:

"cash_account_9f1c3b6e-2a1d-4f8e-9c77-3b0d5e2a41f2"

purpose
string | null

A memo for your own records, recorded on the card's audit trail. It is never sent to the issuer or the merchant, so it does not appear on a statement and does not restrict what the card can buy.

Required string length: 1 - 500
Pattern: ^[ -~]+$
Example:

"Q3 ad spend for the Catnip Coffee Co launch"

expires_at
string<date-time> | null

When the card should stop working. Omit for a card that stays active until you revoke it. Cannot be further out than the issuer allows.

single_use
boolean
default:true

If true, the card is revoked automatically after the first authorization. If false, the card stays usable until expiry or explicit revoke.

Response

Successful Response

controls
CardControls · object
required

The limits and restrictions the card was issued with.

metadata
CardMetadata · object
required

The card's identifier and your memo.

payment_type
string
default:card

Always card, so you can tell this apart from a payment token response.

Allowed value: "card"