Skip to main content
POST
Create a card

Authorizations

Authorization
string
header
required

Type "Bearer" followed by a space and your API token. Obtain your key from the Dash.fi dashboard. Example: "Bearer YOUR_API_KEY"

Body

application/json

Card creation request

Card creation request

name
string
required

Card name. Card name must be unique for cards created unless the previous card with the same name has been archived.

Example:

"adspend card meta"

type
enum<string>
required

Card type. Single-use can be used for a single transaction (exluding auths up to 5$). Recurring can be used for multiple transactions.

Available options:
single-use,
recurring
accountId
integer

Account to create the card on. Required for customer-scoped API keys; optional otherwise and must then match the key's account.

Example:

123

categories
enum<string>[]

Card categories. Categories have specific MCC restrictions. Optional — a card without categories has no merchant restriction. general_expenses overrides all other categories and leaves the card unrestricted. Otherwise WEX accounts accept only airlines, car_rental, car_services, clothing, entertainment, fuel_and_gas, government_services, lodging, restaurants and utilities; any other category is rejected with unsupported-category.

Available options:
advertising,
saas_software,
shipping,
cloud_computing,
professional_services,
airlines,
books_and_newspapers,
car_rental,
car_services,
charitable_donations,
clothing,
clubs_and_memberships,
education,
electronics,
fees_and_financial_institutions,
freight_moving_and_delivery_services,
fuel_and_gas,
general_merchandise,
general_expenses,
government_services,
insurance,
internet_and_phone,
legal,
lodging,
medical,
office_supplies_and_cleaning,
other,
parking,
pet,
restaurants,
supermarkets_and_grocery_stores,
taxes_and_tax_preparation,
taxi_and_rideshare,
travel_misc,
utilities,
entertainment
Example:
expiry
string

Card expiry in YYYYMM format. Cannot be in the past. Earliest possible is current month. Generates random expiration if not provided.

Example:

"202512"

limit
object

Limit to set on card. Optional — a card without a limit is capped only by the account's available balance.

Response

Created card response

id
string<uuid>
required

Card ID.

Example:

"550e8400-e29b-41d4-a716-446655440000"