Skip to main content
POST
Redeem Promo

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
code
string
required
Required string length: 1 - 64
plan
string
default:managed_build

Plan slug to start on the comped window (product_tier, e.g. managed_build). Must be self-serve and match the code's product restriction.

onboarding_answers
OnboardingAnswers · object | null

Signup questions — persisted server-side for GTM attribution, parity with the card path (the no-CC cohort is the highest-sales-relevance cohort; client-event-only isn't joinable with the server-side funnel data). The $5/answer credit is NOT minted here — the comped window bills $0, so there is nothing to offset.

Response

Successful Response

redeemed
boolean
required
code
string
required
plan
string
required
account_type
string
required
subscription_id
string
required
poc_usage_cap_cents
integer | null

POC promo usage ceiling (cents), granted via the subscription webhook (cap_source=poc_promo:*).

duration_in_months
integer | null