Other providers
Register the OAuth app behind each of the other 31 providers, with its scopes, callback and caveats.
Every connector outside Google, Microsoft and Dropbox has its own OAuth app with its provider. Setting one up always takes the same three steps.
This page is for self-hosted installs. On Flowblocks Cloud these connectors work without any setup.
Register the app
Create an OAuth app in the provider's developer settings, listed below for each provider. Give it the scopes in the provider's section. Where a provider sets permissions on the app rather than in the sign-in request, the section says so.
Add the redirect URI
Each connector has one callback. Add it exactly, with localhost rather than 127.0.0.1 and no trailing slash:
http://localhost:3000/api/auth/oauth2/callback/connector_<id>For a deployed app, repeat the same path with the https origin from BETTER_AUTH_URL.
Add the credentials
Put the client id and secret in .env.local under the provider's prefix, then restart the server. For Linear:
LINEAR_CLIENT_ID=
LINEAR_CLIENT_SECRET=A connector only shows as connectable once both values are set.
Engineering
GitHub
- Register: an OAuth App under Developer settings.
- Prefix:
GITHUB_CONNECTOR, kept apart from theGITHUB_*app used for signing in. - Callback:
connector_github - Scopes:
repo,offline_access
GitHub has no read-only scope for private repositories, so the consent screen asks for repo. The connector's tools only read.
GitLab
- Register: an application under Preferences, then Applications, on gitlab.com.
- Prefix:
GITLAB - Callback:
connector_gitlab - Scopes:
read_api,read_user
Only gitlab.com is supported, not self-managed instances.
Bitbucket
- Register: an OAuth consumer under the workspace's Settings, then OAuth consumers.
- Prefix:
BITBUCKET - Callback:
connector_bitbucket - Scopes: tick
account,repositoryandpullrequeston the consumer.
Jira
- Register: an OAuth 2.0 (3LO) app in the Atlassian developer console, with the User Identity and Jira APIs.
- Prefix:
ATLASSIAN - Callback:
connector_jira - Scopes:
read:me,read:jira-work,offline_access
Turn on Distribution sharing so people outside your Atlassian organization can connect.
Linear
- Register: an OAuth application under Settings, then API, in Linear.
- Prefix:
LINEAR - Callback:
connector_linear - Scopes:
read
Sentry
- Register: an API application under User settings, then API applications, in Sentry.
- Prefix:
SENTRY - Callback:
connector_sentry - Scopes:
org:read,project:read,event:read
Each connection covers the one organization picked on Sentry's consent screen.
Projects and notes
Notion
- Register: a public integration in Notion's integration settings.
- Prefix:
NOTION - Callback:
connector_notion - Scopes: set on the integration. Give it read content and read user information.
Confluence
- Register: a second OAuth 2.0 (3LO) app in the Atlassian developer console, with the User Identity and Confluence APIs.
- Prefix:
ATLASSIAN_CONFLUENCE - Callback:
connector_confluence - Scopes:
read:me,search:confluence,read:page:confluence,read:space:confluence,offline_access
Confluence needs its own app because an Atlassian app takes one callback URL. Turn on distribution sharing here too.
Asana
- Register: an app in the Asana developer console.
- Prefix:
ASANA - Callback:
connector_asana - Scopes:
users:read,workspaces:read,workspaces.typeahead:read,projects:read,tasks:read,stories:read
ClickUp
- Register: an app under Settings, then Apps, in ClickUp.
- Prefix:
CLICKUP - Callback:
connector_clickup - Scopes: none. A ClickUp token reads the workspaces the person picks on the consent screen.
monday.com
- Register: an app in monday.com's Developer Center.
- Prefix:
MONDAY - Callback:
connector_monday - Scopes:
me:read,account:read,boards:read,updates:read,workspaces:read
Use the standard OAuth flow and leave OAuth 2.1 off for the app. Promote the app version to Live before other accounts install it.
Todoist
- Register: an app in the Todoist App Management console.
- Prefix:
TODOIST - Callback:
connector_todoist - Scopes:
data:read
Miro
- Register: an app in Miro's developer settings.
- Prefix:
MIRO - Callback:
connector_miro - Scopes:
boards:read
Share the app's install link, or list it on the Miro Marketplace, before people in other teams can connect.
Smartsheet
- Register: an app under Developer Tools in the Smartsheet account menu.
- Prefix:
SMARTSHEET - Callback:
connector_smartsheet - Scopes:
READ_SHEETS
Basecamp
- Register: an integration on 37signals Launchpad.
- Prefix:
BASECAMP - Callback:
connector_basecamp - Scopes: none. Basecamp grants access to every account the person belongs to.
Chat and meetings
Slack
- Register: an app at api.slack.com/apps.
- Prefix:
SLACK - Callback:
connector_slack - Bot scopes:
channels:read,channels:history,users:read
The connector reads as the app's bot, so the bot must be added to a channel before it can read that channel. Until Slack approves the app for its Marketplace, reading history is limited to about one request a minute.
Discord
- Register: an application in the Discord developer portal.
- Prefix:
DISCORD - Callback:
connector_discord - Scopes:
identify,guilds,guilds.members.read
A user's token can read their profile and servers but not messages, which would need a bot.
Zoom
- Register: a general app in the Zoom App Marketplace, under Develop.
- Prefix:
ZOOM - Callback:
connector_zoom - Scopes:
user:read:user,meeting:read:list_meetings,meeting:read:meeting,meeting:read:past_meeting,cloud_recording:read:list_user_recordings,cloud_recording:read:list_recording_files
Add the scopes to the app as granular scopes. Zoom reviews the app before accounts outside yours can install it.
Webex
- Register: an integration at developer.webex.com.
- Prefix:
WEBEX - Callback:
connector_webex - Scopes:
spark:people_read,spark:rooms_read,spark:messages_read,spark:kms,meeting:schedules_read
Files and documents
Airtable
- Register: an OAuth integration in Airtable's developer hub.
- Prefix:
AIRTABLE - Callback:
connector_airtable - Scopes:
data.records:read,schema.bases:read,user.email:read
Figma
- Register: an app in Figma's developer settings.
- Prefix:
FIGMA - Callback:
connector_figma - Scopes:
current_user:read,file_content:read,file_comments:read,file_versions:read
Figma reviews public OAuth apps before people outside your team can sign in.
Box
- Register: a Custom App with user authentication (OAuth 2.0) in the Box developer console.
- Prefix:
BOX - Callback:
connector_box - Scopes:
root_readwrite
Box can't download a file's contents without root_readwrite. The connector's tools only read.
DocuSign
- Register: an app and integration key under Apps and Keys in a DocuSign developer account.
- Prefix:
DOCUSIGN - Callback:
connector_docusign - Scopes:
signature,extended
The eSignature scope has no read-only form; the tools only read. The integration key must pass DocuSign's go-live review before it works in production accounts.
Sales and support
HubSpot
- Register: an app in a HubSpot developer account.
- Prefix:
HUBSPOT - Callback:
connector_hubspot - Scopes:
oauth,crm.objects.contacts.read,crm.objects.companies.read,crm.objects.deals.read
An unlisted app can be installed in 25 accounts. Beyond that, HubSpot has to review and list it.
Pipedrive
- Register: an app in the Pipedrive Developer Hub.
- Prefix:
PIPEDRIVE - Callback:
connector_pipedrive - Scopes:
base,deals:read,contacts:read,search:read, set on the app.
A public Marketplace listing is reviewed.
Attio
- Register: an app in Attio's developer settings.
- Prefix:
ATTIO - Callback:
connector_attio - Scopes:
record_permission:read,object_configuration:read,list_configuration:read,list_entry:read,user_management:read, set on the app.
Close
- Register: an OAuth app under Settings, then Developer, in Close.
- Prefix:
CLOSE - Callback:
connector_close - Scopes:
all.full_access,offline_access
Close has no read-only scope. The connector's tools only read.
Calendly
- Register: an OAuth app in the Calendly developer portal, created as a Production app.
- Prefix:
CALENDLY - Callback:
connector_calendly - Scopes:
users:read,scheduled_events:read,event_types:read
Intercom
- Register: an app in the Intercom Developer Hub, with OAuth turned on.
- Prefix:
INTERCOM - Callback:
connector_intercom - Permissions: set on the app. Give it read access to conversations, contacts and admins.
Only US-hosted Intercom workspaces are supported. Intercom reviews public apps.
Help Scout
- Register: an app under Your Profile, then My Apps, in Help Scout.
- Prefix:
HELPSCOUT - Callback:
connector_helpscout - Permissions: none to set. The token reads what the person can see.
Front
- Register: an app under Settings, then Developers, in Front, with OAuth turned on.
- Prefix:
FRONT - Callback:
connector_front - Permissions: set on the app. Give it read access to conversations and inboxes.
Only a Front company admin can connect it.
Not available yet
Zendesk issues OAuth clients per subdomain, so every customer would have to register their own app. Vercel keeps the permissions to read projects and deployments in private beta. Connect either one through an MCP server for now.