Skip to main content
POST
Subscribe To Plan

Authorizations

Authorization
string
header
required

Mixpeek API key, sent as Authorization: Bearer mxp_sk_.... Create one in Studio under Settings → API Keys, or with an admin key via POST /v1/organizations/users/{user_email}/api-keys. A missing header returns 403; an invalid or revoked key returns 401.

Body

application/json

Request to subscribe to a plan.

plan
string
required

Plan slug: managed_build, managed_scale, mvs_build, mvs_scale. The tier minimum is a billing floor — usage above it bills automatically at the plan's rates.

Examples:

"managed_build"

"mvs_scale"

success_url
string | null
default:https://studio.mixpeek.com/billing?subscription=success

Redirect URL after successful subscription

cancel_url
string | null
default:https://studio.mixpeek.com/billing?subscription=cancelled

Redirect URL if subscription is cancelled

onboarding_answers
OnboardingAnswers · object | null

Optional signup questions; each non-empty answer = $5 off the first invoice (max $10).

promo_code
string | null

Optional promo code to pre-apply at checkout. When combined with onboarding answers, the promo takes checkout's single discount slot and the onboarding credit lands on the customer balance.

Maximum string length: 64

Response

Successful Response

Response with Stripe Checkout Session URL for subscription.

checkout_url
string
required

Stripe Checkout URL for subscription

Example:

"https://checkout.stripe.com/c/pay/cs_live_abc123"

session_id
string
required

Stripe Checkout Session ID (empty string for inline upgrades)

Examples:

"cs_live_abc123"

""