curl --silent --show-error --fail-with-body --request POST \
--url 'https://api.stateset.com/api/v1/subscriptions' \
--header 'Authorization: Bearer YOUR_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 --silent --show-error --fail-with-body --request POST \
--url 'https://api.stateset.com/api/v1/subscriptions' \
--header 'Authorization: Bearer YOUR_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"
}
Confirm your deployment before running this request. This page describes an API contract;
a published reference does not establish hosted availability. Check the dated
host report and obtain your deployment URL and credentials.
Replace the example host if your provisioned service uses a different URL.
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 | — |
Using this contract
Read the source OpenAPI document for declared schemas and alternatives. This page also includes documented corrections from the spec overlays. Example IDs and values are illustrative; replace them with records from your workspace.curl --silent --show-error --fail-with-body --request POST \
--url 'https://api.stateset.com/api/v1/subscriptions' \
--header 'Authorization: Bearer YOUR_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 October 20, 2026