MOmoda
voyager

Voyager Redeem Promo

Changed on

Redeem a promo or referral code for the organization of this credential's workspace.

The same redemption and eligibility as entering the code in the Moda web app, for a Voyager sign-in or a legacy Voyager API key: the billing promo path first, then the referral path when the code is not a promo code. At most 10 attempts per user per 10 minutes.

post/voyager/promo/redeem

Request

  • Base URL
    https://api.moda.app/v1
  • URL
    https://api.moda.app/v1/voyager/promo/redeem
  • Auth
    HTTP bearer

Headers

Moda-Version'2026-04-12' | '2026-05-01'
Example:2026-05-01

Calendar-dated API version pin. New integrations should pin 2026-05-01 to opt into the newest response shapes. For back-compat the server also accepts requests with no header and resolves them to the current default (today: 2026-04-12); that default advances on each sunset date. Any unsupported value returns 400 unsupported_version.

Request body

codestring required

The promo code as the user typed it; surrounding whitespace is ignored.

Response

Successful Response

successboolean required

Whether the promo code was successfully applied

messagestring required

Human-readable message about the result

credits_grantedinteger nullable

Credits this redemption granted.

pro_trial_daysinteger nullable

Length in days of the Pro plan or trial this redemption started, if any.

monthly_creditsinteger nullable

The plan's recurring per-seat credit allowance, when the promo put the workspace on a plan.

Changes