Skip to main content
GET
Get connector connection status

Authorizations

Authorization
string
header
required

Personal access token, sent as Authorization: Bearer <token>.

Path Parameters

app_id
string
required

ID of the app.

Query Parameters

integration_type
required

Connector the authorization is for.

Available options:
googlecalendar,
google_classroom,
googledrive,
gmail,
googlesheets,
googledocs,
googleslides,
googlebigquery,
googlemeet,
googletasks,
googleads,
google_analytics,
google_search_console,
slack,
notion,
salesforce,
hubspot,
linkedin,
tiktok,
instagram,
discord,
slackbot,
wix,
github,
gitlab,
bamboohr,
dropbox,
clickup,
wrike,
box,
outlook,
linear,
airtable,
microsoft_teams,
share_point,
one_drive,
typeform,
splitwise,
hugging_face,
calendly,
contentful,
supabase,
snowflake,
databricks,
quickbooks,
square
connection_id
string
required

connection_id returned by Start connector connection.

Response

Where the authorization stands.

Where a connector authorization stands.

status
enum<string>
required

State of the authorization. PENDING while it's still in progress, ACTIVE once the connection is ready to use, or FAILED if it was refused, expired, or couldn't be completed.

Available options:
ACTIVE,
FAILED,
PENDING
Example:

"ACTIVE"

status_reason
string | null

Why the authorization failed, when status is FAILED and you started it. The value is null otherwise.

Example:

"OAuth provider returned access_denied"