This reference lists available public methods for our OAuth 2 endpoints.

0. Create an OAuth client

Please send an email to filip@tally.so 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

2. Account authorizes your request

We will redirect back to your REDIRECT_URI.