Skip to main content
You need a Wistia account with permission to create OAuth applications. OAuth2 is not enabled by default for every account — if the OAuth Applications tab is missing, contact Wistia Support to have it enabled before you start (this can take 1-2 business days).

​
Enable OAuth2 access

Confirm OAuth2 is enabled for your account, and request it if it is not.

1

Check for the OAuth Applications tab

Click your account avatar in the top-right corner and select Settings, then look for the OAuth Applications tab in the left sidebar.

  • If the OAuth Applications tab is visible, continue to the next section.
2

Request OAuth2 access if the tab is missing

If the OAuth Applications tab is not shown, OAuth2 is not yet enabled for your account.

  • Open the Wistia Support contact page and start a chat with the support team.
  • Give your account name and ask that OAuth2 be enabled for API integration.
  • Wait for confirmation — this can take 1-2 business days.

​
Create a Wistia OAuth application

Register an OAuth application in Wistia to obtain a Client ID and Client Secret.

1

Sign in to Wistia

Sign in to your Wistia account.

The Wistia sign-in page with the Sign in button highlighted.
2

Open OAuth Applications and start a new application

Click your account avatar in the top-right corner and select Settings, select the OAuth Applications tab in the sidebar, then click New OAuth Application.

3

Configure the application details

Fill in the New OAuth Application form.

  • Enter a Name for the application, for example StackOne Integration.
  • Add an optional Description.
  • In the Callback URL field, enter the Callback URL from your Connector Profile.
The New OAuth Application form showing the Name, Description, Callback URL and Scopes fields and the Save button.
4

Select the required scopes

In the Scopes section, select the permissions this integration needs. For full read and write access, select Read, update & delete anything; otherwise select the individual scopes that match the actions you will use.

  • Read, update & delete anything — full access to read, update, and delete any data.
  • Read all data — read-only access to all data.
  • Read all folder and media data — read media, project, customization, and captions data.
  • Upload media — upload media and fetch data about a single media by hashed ID.
  • Read detailed stats — read statistics data.
5

Grant the StackOne permissions

Enables actions: Archive Media, Bulk Delete Subfolders, Channel Episode Delete, Channel Episode Update, Copy Folder, Copy Media, Create Allowed Domain, Create Captions, Create Channel, Create Channel Episode, Create Folder, Create Subfolder, Create Tag, Create Webinar, Create Webinar Registration, Delete Allowed Domain, Delete Captions, Delete Channel, Delete Customizations, Delete Folder, Delete Media, Delete Subfolder, Delete Tag, Delete Webinar, Get Account, Import Media From URL, List Allowed Domains, List Captions, List Captions By Media, List Channel Episodes, List Channel Episodes By Channel, List Channels, List Folder Sharings, List Folders, List Media, List Subfolders, List Tags, List Webinars, Move Media, Publish Channel Episode, Purchase Captions, Restore Media, Show Allowed Domain, Show Captions, Show Channel, Show Customizations, Show Folder, Show Media, Show Media Aggregated Stats, Show Media Analytics, Show Subfolder, Show Webinar, Swap Media, Translate Media, Unpublish Channel Episode, Update Captions, Update Channel, Update Customizations, Update Folder, Update Media, Update Subfolder, Update Webinar

StackOne requests the following permissions when connecting. Make sure your OAuth application grants at least these scopes.

6

Save and copy your credentials

Click Save to create the application, then open it to view its credentials.

  • Copy the Client ID and paste it into the Client ID field in the StackOne Connector profile.
  • Copy the Client Secret and paste it into the Client Secret field in the StackOne Connector profile.
  • Keep the Client Secret confidential and store it securely for later use.

​
Create the StackOne Connector Profile

1

Create a Connector Profile

Enable the connector and create a Connector Profile in your project. See Setup Connector Profile.
2

Link an Account

Once the Connector Profile is created, continue to link an account.