> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mithunai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Start linking your Slack account

> Open the link the Slack bot sent you and get the code that finishes linking. Nothing is linked yet.

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 (`403`).

> [!WARNING]
>
> 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.

**token** `string` *required*

The token from the link the bot sent you in a direct message -- the part after `#slack-link=`.

## Response

Returns `202` and `data`:

**data.code** `string`

Six digits. Send it to the bot in the direct message where it sent you the link.

**data.expires\_at** `string`

When the code stops working, in UTC.

Whether the link is made yet is [Read your linked Slack account](https://docs.mithunai.com/api-reference/slack/get-identity.md): `data` is `null` until the bot has the code.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.