createCreditCurrency

Create a credit currency

​

Creates a credit currency: a separate kind of credit, with its own balances, alongside the default credits currency. Charges can grant credits in it and price usage in it, and you can grant it by hand. key is how you name the currency in grants and filters; it can't be changed later, and a key that's already taken is a 409 DUPLICATE_KEY (credits is always taken). The new currency is active.

Body·

required
application/json
  • key
    Type: string
    required

    A unique key of lower-case letters, digits, _ and -. Can't be changed later.

  • name
    Type: string
    min length:  
    1
    required

    The currency's name, for people.

  • description
    Type: string | null

Responses

  • application/json
  • application/json
  • application/json
Request Example for post/credits/currencies
curl https://billing.getspondo.com/api/v1/credits/currencies \
  --request POST \
  --header "Authorization: Bearer $SPONDO_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "name": "Expert reviews",
    "key": "expert-reviews",
    "description": "Contract reviews by a qualified lawyer, sold in packs."
  }'


{
  "id": "cc_W5h1Jp8Ds3Fy6Nq0",
  "name": "Expert reviews",
  "key": "expert-reviews",
  "status": "active",
  "description": "Contract reviews by a qualified lawyer, sold in packs.",
  "archivedAt": null,
  "createdAt": "2026-11-02T10:15:00.000Z",
  "updatedAt": "2026-11-02T10:15:00.000Z"
}

The credit currency was created.

Previous
Credits
Next
List credit currencies