This reference lists available methods for our OAuth 2 endpoints.

<aside> <img src="/icons/exclamation-mark-double_orange.svg" alt="/icons/exclamation-mark-double_orange.svg" width="40px" /> The OAuth API is currently intended for use only by integration providers.

</aside>

0. Create an OAuth client

Please send an email to [email protected] and provide the following information:

• Name and a link to your service
• A short description of what you want to build
• 144x144 icon of your service
• OAuth redirect URIs

1. Authorize the account

Send the user to the authorize URL mentioned below and replace the placeholders with your own data.

GET <https://tally.so/oauth/authorize?client_id=[CLIENT_ID]&grant_type=authorization_code&response_type=code&scope=[REQUIRED_SCOPES]&redirect_uri=[REDIRECT_URI]&state=[PROVIDED_BY_YOU]>

Available scopes

user — allows access to the account's name, email, avatar, etc

forms — allows access to a list of the account's forms

responses — allows access to a form's responses

webhooks — allows you to read and manage webhooks