Skip to Content

Billing

Redeem a trial code

Redeems a trial code before the first subscription. Its days add to the plan’s own free trial when the workspace subscribes, shown as extra_trial_days in the billing state it answers. A code works once per workspace; redeeming it again changes nothing. An event’s promo code can be redeemed until the event ends. Refused (billing_trial_code_rejected) for an unknown code, an event code that ended, a workspace that already subscribed, or one that already used a free trial.

POST
/billing/trial-codes

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
codestringrequired

Response

application/json

Success

plansobject[]required

The plans on offer: monthly plans cheapest first, then yearly plans cheapest first; each tier is sold monthly and yearly under the same name.

add_onsobject[]required

Packs a subscribed workspace can add to its plan each month: LinkedIn accounts, email inboxes and team seats.

extra_trial_daysintegerrequired

Days that redeemed trial codes add to the plan's own free trial on a first subscription; 0 when none were redeemed or the workspace already used a trial.

credit_top_upobject | nullrequired

Credits a subscribed workspace can buy once, spent after the plan's monthly credits and kept until used; null when none are sold.

subscriptionobject | nullrequired

The workspace's current subscription; null when it has none.

usageobjectrequired

Usage of each entitlement: credits, linkedin_accounts, email_inboxes and team_members.