> ## 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.

# Invite a colleague by email

> Send someone a link to join your organisation; they choose their own password. How long a link lasts, re-sending it, and withdrawing it.

An invitation is an email with a link. The person opens it, chooses a password, and joins your organisation with the role you picked. They do not need an account beforehand.

> [!NOTE]
>
> Invitations need this deployment to be able to send email. If it cannot, **Settings → Members**
> says so and the invite form is turned off. Ask the person who runs your MITHUNAI deployment to set
> up email. Invitations are in beta: a test message from the hosted service has arrived in a real
> inbox, but the invitation message itself has not yet been tried with a real address.

## Send an invitation

1. Open **Settings → Members**.
2. Under **Invite by email**, enter their email address and choose a role.
3. Press **Send invitation**.

Only Owners and Administrators can invite, and nobody can invite to a role above their own. Nobody is ever invited as the Owner.

## What the person sees

They receive an email naming who invited them and to which organisation. The link opens a page that shows the organisation and role, and asks for:

* **their name and a new password**, if they are new; or
* **the password they already use**, if their email address already has an account here. Their account and password are not changed, and they are added to your organisation.

Accepting does not sign them in. They sign in afterwards with their email and password.

## How long a link lasts

A link works **once** and for **seven days**. After that it stops working, and the invitation shows as **Expired** in your pending list.

## Re-send or withdraw

The **Pending invitations** list shows everyone who has been sent a link and has not joined yet.

* **Re-send** emails a new link with a fresh seven days. The link sent before stops working, so tell them to use the newest email. This works for expired invitations too.
* **Revoke** withdraws the invitation. The link stops working straight away. You can invite the same address again later.

An invitation already accepted is not in the list: that person is a member now. See [Members](https://docs.mithunai.com/administration/members.md) to change or remove them.

## Limits

* One open invitation per email address. To send another, re-send the one that is there.
* An organisation can send 30 invitation emails an hour.
* If someone is removed, the invitations they sent are withdrawn.

For the API, see [Send an invitation](https://docs.mithunai.com/api-reference/invitations/create-invitation.md).


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