Account & billing  /  Create subscription

Create subscription

POST/v1/subscription

Start a paid subscription on a plan. The account needs a payment method first, so collect a card with a setup intent (below) and pass the resulting payment method id here.

Body parameters
plan_id
string · required
The plan to subscribe to: standard or premium.
payment_method_id
string · required
A Stripe payment method id from a confirmed setup intent.
Response fields
id
string
Prefixed identifier, e.g. sub_3ZLn….
plan_id
string
Current plan: standard, premium, or enterprise.
plan_name
string
Display name of the plan, e.g. Standard.
price
integer
Monthly price in cents (1900 = $19). 0 for enterprise.
status
string
trialing, active, past_due, canceled, or trial_expired.
trial_ends_at
timestamp | null
When the trial ends, or null when not on a trial.
trial_type
string | null
cardless (no card yet) or carded (card on file).
current_period_end
timestamp | null
When the current billing period ends.
cancel_at_period_end
boolean
Always false. Cancellation is immediate, not deferred.
flows_limit
integer
Flows allowed on this plan. -1 means unlimited.
conversions_limit
integer
Monthly conversions allowed. -1 means unlimited.
POST/v1/subscription
curl https://app.converly.io/api/v1/subscription \
  -H "Authorization: Bearer sk_live_…" \
  -d '{
    "plan_id": "standard",
    "payment_method_id": "pm_1Nx…"
  }'
201 Created
{
  "id": "sub_3ZLn…",
  "plan_id": "standard",
  "plan_name": "Standard",
  "price": 1900,
  "status": "active"
}