WIwistia
Account Trials

Start Account Trial

Changed on

Starts a business-tier trial on the current account. The plan tier is hardcoded — the only caller is the Wistia desktop app's "Invite and start trial" onboarding CTA.

Requires the current contact to be authorized to start the trial via the account's AccountPolicy — otherwise returns 403.

Expiring access tokens with authorizations cannot use this endpoint: starting a trial is an account-level action authorized as the persisted contact, not through a token's authorizations. Such requests are forbidden.

Requires api token with one of the following permissions

Read, update & delete anything
post/account/trials

Request

  • Base URL
    https://api.wistia.com/modern
  • URL
    https://api.wistia.com/modern/account/trials
  • Auth
    HTTP bearer

Headers

X-Wistia-API-Versionstring required

Response

Trial started

trial_expires_atstring date-time nullable required

ISO 8601 timestamp when the trial expires. Null if the trial has no end date.

plan_tierstring nullable required

The plan tier now active on the account.

is_trialboolean required

Always true on success.

Changes