Skip to main content
POST
/
stripe
/
connect
/
accounts
/
{accountId}
/
promotion-codes
Create Promotion Code
curl --request POST \
  --url https://api.chat-dash.com/v1/public/stripe/connect/accounts/{accountId}/promotion-codes \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "data": {
    "coupon": "rgJkxQB4",
    "code": "SUMMER20",
    "customer": "cus_TppcYxuTJKLNnG",
    "max_redemptions": 10,
    "expires_at": 1770137940,
    "restrictions": {
      "first_time_transaction": true,
      "minimum_amount": 1000,
      "minimum_amount_currency": "usd"
    }
  }
}
'
{
  "id": "promo_1SucFwRjNw7C4HMK01fsfjOh",
  "object": "promotion_code",
  "active": true,
  "code": "SUMMER20",
  "coupon": {
    "id": "rgJkxQB4",
    "object": "coupon",
    "amount_off": null,
    "created": 1751915454,
    "currency": "usd",
    "duration": "repeating",
    "duration_in_months": 3,
    "livemode": true,
    "max_redemptions": null,
    "metadata": {},
    "name": "3Months Off",
    "percent_off": 10,
    "redeem_by": null,
    "times_redeemed": 6,
    "valid": true
  },
  "created": 1769620216,
  "customer": "cus_TppcYxuTJKLNnG",
  "customer_account": null,
  "expires_at": 1770137940,
  "livemode": true,
  "max_redemptions": 10,
  "metadata": {},
  "restrictions": {
    "first_time_transaction": true,
    "minimum_amount": null,
    "minimum_amount_currency": null
  },
  "times_redeemed": 0
}

Headers

​
Authorization
string
required

All requests to the ChatDash API must be validated with the agency API Key found on your agency profile

Path Parameters

​
accountId
string
required

The Stripe connected account ID

Body

application/json
​
data
object
required

Response

Created

​
id
string

Unique identifier for the promotion code

Example:

"promo_1SucFwRjNw7C4HMK01fsfjOh"

​
object
string

Object type

Example:

"promotion_code"

​
active
boolean

Whether the promotion code is active

Example:

true

​
code
string

The customer-facing code

Example:

"SUMMER20"

​
coupon
object

The coupon associated with this promotion code

​
created
integer

Unix timestamp of when the promotion code was created

Example:

1769620216

​
customer
string | null

The customer that this promotion code can be used by

Example:

"cus_TppcYxuTJKLNnG"

​
customer_account
string | null
Example:

null

​
expires_at
integer | null

Unix timestamp of when the promotion code expires

Example:

1770137940

​
livemode
boolean
Example:

true

​
max_redemptions
integer | null
Example:

10

​
metadata
object
Example:
{}
​
restrictions
object
​
times_redeemed
integer
Example:

0