Start linking your Slack account
Open the link the Slack bot sent you and get the code that finishes linking. Nothing is linked yet.
Start linking your Slack account
curl --request POST \
--url https://app.mithunai.com/mithunai/api/v1/integrations/slack/identity \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"token": "<string>"
}
'import requests
url = "https://app.mithunai.com/mithunai/api/v1/integrations/slack/identity"
payload = { "token": "<string>" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({token: '<string>'})
};
fetch('https://app.mithunai.com/mithunai/api/v1/integrations/slack/identity', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"data.code": "<string>",
"data.expires_at": "<string>"
}Opening the link links nothing. It returns a six-digit code, and the link is made only when the Slack user who asked the bot for it sends that code back to the bot, in the same direct message, within ten minutes. After that, pressing an approval card in Slack decides as you, with your own permissions — exactly as if you decided in the console.
Both sides have to prove control: you, signed in, by opening the link; the Slack account, by sending the code. A link forwarded to someone else and opened by them links nobody, unless the code also reaches that Slack account.
The token works once and for fifteen minutes. The code works for ten minutes and five tries, and is kept only as a salted hash. A link is never matched by e-mail, an API key cannot link anyone, and a link is never made across organisations (
Whether the link is made yet is Read your linked Slack account:
403).
Send the code only from your own Slack account, and never give it to anyone: whoever sends it from
their Slack account approves as you.
string
required
The token from the link the bot sent you in a direct message — the part after
#slack-link=.Response
Returns202 and data:
string
Six digits. Send it to the bot in the direct message where it sent you the link.
string
When the code stops working, in UTC.
data is null until the bot has the code.Last modified on November 11, 2026
Start linking your Slack account
curl --request POST \
--url https://app.mithunai.com/mithunai/api/v1/integrations/slack/identity \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"token": "<string>"
}
'import requests
url = "https://app.mithunai.com/mithunai/api/v1/integrations/slack/identity"
payload = { "token": "<string>" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({token: '<string>'})
};
fetch('https://app.mithunai.com/mithunai/api/v1/integrations/slack/identity', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"data.code": "<string>",
"data.expires_at": "<string>"
}