Integrations

Get OAuth authorization URL

Returns an OAuth authorization URL to connect a user's Gmail, Slack, Outlook, or other integration.

Flow:

  1. Call this GET endpoint with provider to get an authUrl
  2. Redirect the user to the authUrl
  3. After user authorizes, they're redirected back with a code
  4. Call POST /v1/users/:user_id/integrations/connect with the code to complete the connection

Supported providers: gmail, slack, outlook, teams

get/v1/users/{user_id}/integrations/connect

Request

  • Base URL: http://0.0.0.0:3000
  • URL: http://0.0.0.0:3000/v1/users/{user_id}/integrations/connect
  • Auth: none declared

Path parameters

user_idstring uuid required

Query parameters

provider'gmail' | 'slack' | 'outlook' | 'google_calendar' | 'google_meet' | 'teams' required

Integration provider (gmail, slack, outlook, google_calendar, google_meet, teams)

statestring

OAuth state parameter. May be a JSON or base64url JSON object with redirect_url for per-flow completion redirects.

reconnectstring

Integration ID to reconnect (int_xxx format)

Response

Default Response

successboolean required
authUrlstring required

OAuth authorization URL to redirect to

Changes

No recorded changes to this operation across all 1 revision of this API.