Skip to main content
A personal access token acts as your own Typeform user and cannot be scoped to a different one. All scopes grants it Full access to read and write, while Custom scopes limits it to the permissions you select.

Generating a personal access token

Typeform authenticates API requests with a personal access token generated from your account settings. The token does not expire, and the scopes you pick cannot be changed afterward.

1

Open your account settings

Sign in to your Typeform account, then open your account from the top-right corner.

  • Click your avatar in the top-right corner.
  • Under ACCOUNT, click Account settings.
The Typeform account menu open, with Account settings below the ACCOUNT heading.
2

Open the Personal tokens page

In the Account menu on the left, click Personal tokens.

The Typeform Account settings page with Personal tokens in the left menu.
3

Name the token

Click Generate a new token to open the Generate a new token dialog, then name it.

  • Token name: StackOne Integration
The Personal tokens page with the Generate a new token button.
4

Choose the scopes

Enables actions: Add Workspace Member, Create Form, Create Image, Create Theme, Create Workspace, Delete Form, Delete Image, Delete Responses, Delete Theme, Delete Workspace, Get Background Image By Size, Get Choice Image By Size, Get Form, Get Form Messages, Get Image, Get Image By Size, Get Theme, Get Unified Credentials, Get Unified Group, Get Unified Organization, Get Unified Role, Get Unified User, Get Workspace, List Forms, List Images, List Responses, List Themes, List Unified Groups, List Unified Organizations, List Unified Roles, List Unified Users, List Workspaces, Patch Theme, Remove Workspace Member, Update Form, Update Theme

Under Scopes, choose how much access the token carries. Select All scopes for Full access to read and write, or select Custom scopes to limit the token and enable just the Read and Write permissions your integration needs. Each resource — Accounts, Forms, Images, Responses, Themes, Webhooks and Workspaces — has its own checkboxes, and selecting Custom scopes enables all of them.

The Generate a new token dialog with Custom scopes selected, showing Read and Write checkboxes per resource.
5

Copy the token

Click Generate token, then copy the Personal access token into StackOne Hub.

  • We’ll show you this token just once — the token is only displayed once and cannot be retrieved later.
  • If you lose the token, generate a new one and update the connection.
The New token created dialog with the Personal access token value redacted and the copy control highlighted.

Find your form IDs for webhook events

Typeform registers webhooks on individual forms, so the forms to subscribe to are named when the account is connected. Leave Webhook Form ID empty if you are not using webhook events.

1

Copy each form ID

Open a form in the Typeform builder and copy the ID from the address bar.

  • Format: https://admin.typeform.com/form/{form_id}/create
  • Example: in https://admin.typeform.com/form/abc123/create the form ID is abc123
2

Enter the form IDs

Copy the form IDs into StackOne Hub, separated by commas — a webhook is created on each form listed. The token needs the Webhooks Write scope for this.

1

Connect

  • Click Connect.
  • If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider’s authorization flow.
  • Once authorization is successful, you will see a confirmation popup.
2

Use Actions

Connect an AI platform to the linked account’s actions. See AI Platforms.Other ways to call actions are listed in Protocols & SDKs.