v1

latestOpenAPI 3.1.02026-07-226168131.5 KB
Auth Service (v2)

Import Oauth Token

Persist a directly-obtained OAuth token (no authorization-code exchange).

The Slack managed-install flow receives a bot token inline from apps.managedInstall instead of through the browser OAuth redirect. This stores it (Fernet-encrypted at rest, via create_oauth_token) for the caller's org/user against an existing provider. Requiring the provider to already exist in the caller's org scopes the write and blocks cross-org token creation. The token value is never logged or returned.

post/v2/auth/tokens/import

Request body

provider_idstring required
access_tokenstring required
refresh_tokenstring nullable
expires_in_secondsinteger nullable
scopesstring[]
metadataobject nullable
is_defaultboolean

Response

Successful Response

token_idstring required