/oauth.v2.access

GET

/oauth.v2.access

Exchanges a temporary OAuth verifier code for an access token.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://slack.com/api/oauth.v2.access?code='

Response Example

200 - response

{
    "access_token": "xoxb-17653672481-19874698323-pdFZKVeTuE8sk7oOcBrzbqgy",
    "app_id": "A0KRD7HC3",
    "authed_user": {
        "access_token": "xoxp-1234",
        "id": "U1234",
        "scope": "chat:write",
        "token_type": "user"
    },
    "bot_user_id": "U0KRQLJ9H",
    "enterprise": {
        "id": "E12345678",
        "name": "slack-sports"
    },
    "ok": true,
    "scope": "commands,incoming-webhook",
    "team": {
        "id": "T9TK3CUKW",
        "name": "Slack Softball Team"
    },
    "token_type": "bot"
}

Request

Query Params

client_id

string

optional

Issued when you created your application.

client_secret

string

optional

Issued when you created your application.

code

string

required

The code param returned via the OAuth callback.

redirect_uri

string

optional

This must match the originally submitted URI (if one was sent).

Responses

🟢200Successful token request with scopes for both a bot user and a user token

application/json

Body

This method either only returns a brief _OK_ response or a verbose schema is not available for this method.

enum<boolean>

required

Allowed value:

true

Additional properties

integer | number | string | boolean

optional

🔴500Typical error response

Modified at 2023-08-15 05:39:46

/oauth.token

/pins.add