Sample - Slack Web API
GET/oauth.access

Exchange an OAuth verifier code

Exchanges a temporary OAuth verifier code for an access token for a single-scope authorization flow. Supply the code returned through the OAuth callback and the application credentials, and ensure redirect_uri matches the URI originally submitted when one was used. Set single_channel only when requesting installation to a single channel for a legacy workspace app.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

5 parameters
client_idstringoptional
Application identifier issued when the application was created.
client_secretstringoptional
Application secret issued when the application was created.
codestringoptional
Temporary verifier code returned through the OAuth callback.
redirect_uristringoptional
Redirect URI that must match the originally submitted URI when one was provided.
single_channelbooleanoptional
Set to true to request installation in a single channel; valid only for a legacy workspace app.

2 status codes
200Returns an object with `ok` set to true confirming successful user token negotiation.
okbooleanrequired
Allowed:true
defaultReturned when the OAuth verifier, application credentials, redirect URI, or installation options are invalid; the response includes `ok` set to false.
okbooleanrequired
Allowed:false

Error handling

Use the code returned by the OAuth callback together with the client_id and client_secret issued for the application. If redirect_uri is supplied, it must exactly match the originally submitted URI; single_channel is valid only for a legacy workspace app.