REST APIBilling

Start a subscription checkout

View as Markdown

Returns an embedded Stripe Checkout clientSecret to subscribe the account for the given interval. Quantity is set server-side to the account’s current phone-number count (one unit per number) — Dial doesn’t subscribe a subset. Coverage begins when the invoice is paid. Not available during impersonation.

Authentication

AuthorizationBearer

Your Dial API key, sent as Authorization: Bearer sk_live_...

Request

This endpoint expects an object.
intervalenumRequired
Allowed values:
returnUrlstringOptionalformat: "uri"
Where Checkout returns after completion. Defaults to the dashboard billing page.

Response

Embedded Checkout client secret.
clientSecretstring

Errors

400
Bad Request Error
401
Unauthorized Error