> ## 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 Teams account

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

Opening the link links **nothing**. It returns a six-digit code, and the link is made only when the Teams user who asked the bot for it sends that code back to the bot, in the same chat, within ten minutes. After that, pressing an approval card in Teams 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 Teams account, by sending the code. A link forwarded to someone else and opened by them links nobody, unless the code also reaches that Teams 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 Teams account, and never give it to anyone: whoever sends it from
> their Teams account approves as you.

**token** `string` *required*

The token from the link the bot sent you in a personal chat -- the part after `#teams-link=`.

## Response

Returns `202` and `data`:

**data.code** `string`

Six digits. Send it to the bot in the chat 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 Teams account](https://docs.mithunai.com/api-reference/teams/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.