Connect a tool integration

Initiates an OAuth connection flow for a third-party tool. Returns a redirect URL the customer must open in a browser to complete authorization.

Authentication

api-keystring

Your Atlas API key. Get it from the Atlas Portal under Settings > API Keys.

Request

This endpoint expects an object.
toolkitstringRequired

Identifier of the integration to connect (e.g. gmail, google-calendar).

Response

Connection initiated
redirectUrlstringOptionalformat: "uri"
URL to open in a browser to complete OAuth authorization.
expiresAtdatetimeOptional
Expiration time for the redirect URL.

Errors

400
Bad Request Error
500
Internal Server Error