Skip to main content

​
Prerequisites

Before continuing, you should have already completed the following for this connector:
1

Configure the Connector

Enable the connector and set up its connector profile in your project. See Managing Connectors.

Connector Profile

Wistia - OAuth 2.0

Connector Profile

Wistia - API Token
2

Link an Account

Connect an account using StackOne Hub or Auth Link.

Link Account

Wistia - OAuth 2.0

Link Account

Wistia - API Token

​
Copy your Native Webhook URL

The Native Webhook URL is the endpoint Wistia sends events to. It is generated per connection and shown on the connected account.

  • Open the connected Wistia account in StackOne Hub.
  • Copy the read-only Native Webhook URL value.
  • Note: This URL is only available after the account has been connected.

​
Open Webhooks in Wistia

Wistia webhooks are managed under your account settings.

1

Sign in to Wistia

Sign in to your Wistia account.

2

Open the Webhooks settings

Click your account avatar in the top-right corner and select Settings, then in the left Settings sidebar click Webhooks (listed below API Home).

  • You can also go straight to the page at https://<your-account>.wistia.com/account/webhooks.
The Wistia Settings sidebar and Webhooks page with the New webhook button.
3

Create a new webhook

Click New webhook to open the webhook configuration form.

The Webhooks page with the New webhook button highlighted.

​
Configure and save the webhook

Enter the StackOne endpoint, set a secret, and choose which events to receive.

1

Paste the Native Webhook URL

In the Post URL field, paste the Native Webhook URL you copied from StackOne.

The New webhook form showing the Post URL and Secret key fields and the event checkboxes.
2

Set the Secret key

In the Secret key field, enter a secret value of your choice. Wistia uses it to sign every delivery (HMAC-SHA256 hex) in the X-Wistia-Signature header so the payloads can be verified as authentic.

  • Choose a strong, random value — for example a UUID like 123e4567-e89b-12d3-a456-426614174000.
  • Paste the same value into the Webhook Secret Key field on the connected Wistia account in StackOne Hub and save, so the key is stored and available for verifying delivery authenticity.
3

Select the events to receive

Under Events, tick the checkboxes for the events you want delivered. Use Select all on a group to enable every event in that group.

  • Media events: Processing, Ready, Failed, Created, Updated, Deleted.
  • Transcription events: Transcript Updated, Transcript Failed, Transcript Translated, Localization Created, Localization Failed.
  • Viewing session events: Percent Watched, Call To Action Converted, Annotation Converted, Wistia Form Converted, Play.
  • Webinar events: Webinar Registration, Webinar Started, Webinar Ended.
  • Optional: under Folders, limit the webhook to specific folders. Leave empty to receive events from all folders.
The New webhook form event groups (Media, Transcription, Viewing session, Webinar) each with a Select all control.
4

Save the webhook

Click Save. Wistia begins delivering the selected events to your Native Webhook URL, signed with your Secret key.

​
Verify

Your Connector should now be able to receive and process events. Try triggering an event and you should see an Event appear in the Connector logs.