Account & billing / Update subscription

Update subscription

PATCH/v1/subscription

Move the subscription to a different plan. Plan limits update immediately. Requires the billing:write permission.

Body parameters

plan_id

string · required

The plan to switch to: standard, premium, or enterprise.

Response fields

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.

PATCH/v1/subscription

curl -X PATCH https://app.converly.io/api/v1/subscription \
  -H "Authorization: Bearer sk_live_…" \
  -d '{ "plan_id": "premium" }'

200 OK

{
  "id": "sub_3ZLn…",
  "plan_id": "premium",
  "plan_name": "Premium",
  "price": 4900,
  "status": "active"
}