Skip to content

Finish a Slack install: check the `state`, spend it, exchange the code.

POST
/integration/slack
curl --request POST \
--url https://api.siteqwality.com/integration/slack \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "state": "example", "code": "example", "error": "example", "friendly_name": "example" }'
Media type application/json
object
state

The state Slack returned to the callback, as issued by POST /integration/slack/install.

string | null
code

The code Slack returned. Absent when the user declined.

string | null
error

The error Slack returned instead of a code (access_denied).

string | null
friendly_name

Defaults to the Slack workspace name. Other fields, such as an old client’s redirect_uri, are ignored: the state carries the redirect.

string | null
Example generated
{
"state": "example",
"code": "example",
"error": "example",
"friendly_name": "example"
}

This workspace was already connected; its integration now has the new token

Slack integration added

Missing, foreign, expired or reused state; declined, expired or reused code; an org-wide install

Missing or invalid authentication

Not an admin, or not a dashboard session

Name over 256 characters

Slack could not be reached, or refused our app’s credentials

The credentials could not be sealed; nothing was saved, try again