curl --request POST \
--url 'https://api.stateset.com/api/v1/subscriptions' \
--header "Authorization: Bearer $STATESET_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"coupon_code": "string",
"customer_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"payment_method_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"plan_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"skip_trial": true
}'
{
"billing_interval": "string",
"created_at": "2026-08-31T14:22:05Z",
"currency": "USD",
"customer_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"price": "49.00",
"status": "pending",
"updated_at": "2026-08-31T14:22:05Z"
}
Create a subscription
Create a subscription
POST
/
api
/
v1
/
subscriptions
curl --request POST \
--url 'https://api.stateset.com/api/v1/subscriptions' \
--header "Authorization: Bearer $STATESET_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"coupon_code": "string",
"customer_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"payment_method_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"plan_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"skip_trial": true
}'
{
"billing_interval": "string",
"created_at": "2026-08-31T14:22:05Z",
"currency": "USD",
"customer_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"price": "49.00",
"status": "pending",
"updated_at": "2026-08-31T14:22:05Z"
}
Request body
CreateSubscriptionRequest
string,null
string (uuid)
required
string,null
string (uuid)
required
boolean,null
Response
SubscriptionResponse
string
required
string
required
string
required
string
required
string
required
string
required
string
required
string
required
Status codes
| Code | Meaning |
|---|---|
201 | — |
400 | — |
curl --request POST \
--url 'https://api.stateset.com/api/v1/subscriptions' \
--header "Authorization: Bearer $STATESET_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"coupon_code": "string",
"customer_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"payment_method_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"plan_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"skip_trial": true
}'
{
"billing_interval": "string",
"created_at": "2026-08-31T14:22:05Z",
"currency": "USD",
"customer_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"price": "49.00",
"status": "pending",
"updated_at": "2026-08-31T14:22:05Z"
}
Last modified on August 31, 2026