> For the complete documentation index, see [llms.txt](https://docs.maiagent.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.maiagent.ai/maiagent-user-guide/en/start/invitation.md).

# Invitation: Join an Organization

How to register or log in and join an organization after receiving an invitation from your company administrator: the difference between an invitation email and an invitation link, validity period and

When your company administrator adds you to a MaiAgent organization, you may receive an invitation email, an invitation link, or an activation email asking you to set a password. This page is for **invited employees**: complete registration or login based on what you have in hand, and once logged in you can use the Agents and MaiGPT that the organization has opened to you. For how administrators send invitations, see [Member Management](https://docs.maiagent.ai/maiagent-user-guide/en/org/overview/member.md).

{% hint style="info" %}
If you **already have a MaiAgent account** and the administrator invites you by email, the system adds you to the organization directly and **does not send an email**. After refreshing the page or logging in again, you will see the new organization in the organization switcher (see [Switching When You Belong to Multiple Organizations](#switch-organization)).
{% endhint %}

## First, Identify Which Kind of Invitation You Received <a href="#invitation-types" id="invitation-types"></a>

| What you received                                                              | What it means                                                             | What to do                                                                                                                     |
| ------------------------------------------------------------------------------ | ------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| An email whose subject contains "invites you to join"                          | The administrator invited you by email, and you don't have an account yet | Click the link in the email to register; see [Register with an Invitation Email or Invitation Link](#register-from-invitation) |
| An organization invitation link forwarded by a colleague or in an announcement | A shared link generated by the administrator that many people can use     | Click the link to register; the steps are the same as above                                                                    |
| An email whose subject contains "Welcome, please set your password"            | The administrator has already created an account for you from a list      | Click the link in the email to set your password; see [Log In After Setting Your Password](#set-password)                      |
| No email, but the organization already appears in your organization list       | You already had an account and were added directly                        | Switch to that organization and start using it                                                                                 |

## Register with an Invitation Email or Invitation Link <a href="#register-from-invitation" id="register-from-invitation"></a>

{% stepper %}
{% step %}

### Open the Invitation Link <a href="#open-invitation-link" id="open-invitation-link"></a>

Click the link in the invitation email, or open the invitation link shared by the administrator directly. Your browser opens the MaiAgent registration screen, with the <mark style="color:blue;">Invitation Code</mark> field already filled in.
{% endstep %}

{% step %}

### Fill In the Registration Details <a href="#fill-registration" id="fill-registration"></a>

| Field                                                                                       | Description                                                                                                                                                                                                  |
| ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| <mark style="color:blue;">Full Name</mark>                                                  | Your name, shown in the organization member list                                                                                                                                                             |
| <mark style="color:blue;">Company Name</mark>                                               | Your company name                                                                                                                                                                                            |
| <mark style="color:blue;">Company Email</mark>                                              | If you received an invitation email, you **must enter the email address that received it**; the system adds you to the organization based on this email                                                      |
| <mark style="color:blue;">Password</mark>／<mark style="color:blue;">Confirm Password</mark> | We recommend at least 9 characters mixing uppercase letters, lowercase letters, numbers, and special symbols (for example `!@#$`); if the strength is insufficient, "Please enter a valid password" is shown |
| <mark style="color:blue;">Invitation Code</mark>                                            | Keep the auto-filled content; do not modify or delete it                                                                                                                                                     |

{% hint style="warning" %}
The explanatory text below the Invitation Code field (recommended use, does not automatically join an organization) applies to **personal referral codes**. An invitation code filled in from an organization invitation link adds you to that organization after registration; when you open the page from an invitation email, you are added based on the company email you enter.
{% endhint %}
{% endstep %}

{% step %}

### Agree to the Terms and Submit <a href="#submit-registration" id="submit-registration"></a>

The <mark style="color:blue;">Register</mark> button can be clicked only after you check "<mark style="color:blue;">I have read and agree to</mark> the Privacy Policy and Terms of Service". If a human verification appears on screen, complete it first. After the <mark style="color:blue;">Registration successful</mark> message appears, clicking the button in the message window takes you back to the login page.
{% endstep %}

{% step %}

### Log In <a href="#first-login" id="first-login"></a>

On the login page, enter the <mark style="color:blue;">Company Email</mark> you just used, click <mark style="color:blue;">Continue</mark>, then enter your password and click <mark style="color:blue;">Log In</mark>. You go straight into the organization with the role permissions the administrator specified in the invitation.
{% endstep %}
{% endstepper %}

## Log In After Setting Your Password <a href="#set-password" id="set-password"></a>

When an administrator adds members in bulk from an Excel list, the system creates accounts directly for people who don't have one yet and sends an email whose subject contains "Welcome, please set your password".

1. Click the link in the email to open the password-setting screen.
2. Enter a new <mark style="color:blue;">Password</mark> and <mark style="color:blue;">Confirm Password</mark> (same rules as above), then click <mark style="color:blue;">Reset</mark>.
3. Return to the login page and log in with that email and the new password.

The password-setting link has a validity period. If the link has expired, click <mark style="color:blue;">Forgot password?</mark> on the login page and reset it with the same email; see [Forgot Password](https://docs.maiagent.ai/maiagent-user-guide/en/start/forget-password.md).

## Invitation Validity Period <a href="#invitation-validity" id="invitation-validity"></a>

| Invitation method            | When it expires                                                                                                                                                                                                            |
| ---------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Invitation email             | No expiration date. It is complete once you register and join with that email; it becomes invalid after the administrator revokes it                                                                                       |
| Organization invitation link | The expiration date is set by the administrator when creating it (default 7 days). It cannot be used after it expires or is disabled by the administrator; before it becomes invalid, multiple people can register with it |

If you didn't receive the invitation email, the administrator can click <mark style="color:blue;">Resend</mark> on that invitation under <mark style="color:blue;">Invitation Status</mark>. A single invitation can be sent **at most 3 times including the first send**, and at least **5 minutes** must have passed since the last send. If fewer than 5 minutes have passed or it has already been sent 3 times, <mark style="color:blue;">Resend</mark> does not appear.

## When Your Company Uses Single Sign-On (SSO) <a href="#sso-login" id="sso-login"></a>

When your company has set up single sign-on, you usually **don't need to set a password on the registration page**:

1. Go to the [login page](https://docs.maiagent.ai/maiagent-user-guide/en/start/login.md), enter your company email, and click <mark style="color:blue;">Continue</mark>.
2. If your company email's domain is bound to single sign-on, the screen indicates that you will be verified through single sign-on, and the button changes to <mark style="color:blue;">Go to Acme SSO Login</mark> (Acme is your organization's name). After you click it, log in on your company's identity verification page.
3. On your first SSO login, the system creates your account automatically. If the administrator has already sent an email invitation to the **same email address**, you also join that organization and receive the specified role.

If your company uses another login method (for example EIP or Keycloak), use the login URL provided by your company instead; for the process, see [Third-Party Login (SSO)](https://docs.maiagent.ai/maiagent-user-guide/en/org/sso.md#first-login).

{% hint style="warning" %}
Organization invitation links are used only on the registration page. If your company uses SSO, ask the administrator to invite your company email by email instead, so that you are automatically added on your first SSO login.
{% endhint %}

When the screen shows "Single sign-on for this organization is suspended. Please contact your system administrator.", single sign-on is temporarily unavailable, and only accounts that have set a platform password can log in with a password; contact your company IT or organization administrator.

## Switching When You Belong to Multiple Organizations <a href="#switch-organization" id="switch-organization"></a>

Each organization's roles, Agents, Credits quota, and API keys are independent, so confirm which organization you are in before taking any action.

* **Switch organizations**: The drop-down at the top of the left menu shows the current organization. Open it and choose the organization to go to (you can type a name to search); the page reloads to that organization's home page. When the left menu is collapsed, click the building icon at the top instead.
* **Keep frequently used organizations at the top**: Click your avatar in the top right → <mark style="color:blue;">Account</mark> → <mark style="color:blue;">My Organizations</mark>, then click <mark style="color:blue;">Pin</mark> on an organization. Pinned organizations appear at the top of the switcher with a pin icon; pinning is stored only in the browser on the current device.

For more account settings, see [Personal Account Settings](https://docs.maiagent.ai/maiagent-user-guide/en/start/profile.md).

## FAQ <a href="#faq" id="faq"></a>

### I never received the invitation email? <a href="#faq-no-email" id="faq-no-email"></a>

First check your spam folder, then ask the administrator to look at the invitation under <mark style="color:blue;">Invitation Status</mark>: when it shows <mark style="color:blue;">Email failed to send</mark> or is still <mark style="color:blue;">Pending</mark>, it can be resent (subject to the 3-send and 5-minute limits above). When the status is <mark style="color:blue;">Pending</mark>, you can also go to the login page and click <mark style="color:blue;">Register</mark>, then complete registration with the **invited email address**; the system adds you to the organization all the same.

### "Invalid referral code." appears when registering? <a href="#faq-invalid-code" id="faq-invalid-code"></a>

The invitation code is no longer valid: the invitation link has expired or been disabled, or the invitation email has been revoked or already used. Ask the administrator to invite you again or provide a new invitation link.

### I finished registering but can't see my company's organization? <a href="#faq-org-missing" id="faq-org-missing"></a>

When registering from an invitation email, the most common cause is entering a different email address from the one that received the email. Tell the administrator the email address you actually registered with so they can invite you again; because you already have an account, the system adds you to the organization directly.

### I already have an account, but the invitation link won't let me register? <a href="#faq-existing-account" id="faq-existing-account"></a>

Invitation links can only be used to register new accounts. If you already have an account, ask the administrator to invite the email address you currently log in with by email, and you will be added to the organization directly.

### I received a Credits quota right after joining. Is that normal? <a href="#faq-initial-quota" id="faq-initial-quota"></a>

Yes. If the organization has set a "default quota for new members", or the administrator who invited you set a separate quota in the invitation, you automatically receive a personal quota the moment you join, and its validity period starts from the time you joined. To check it, see [Members Checking Their Own Quota](https://docs.maiagent.ai/maiagent-user-guide/en/others/credits/member-credit-quota.md#member-self-check). If the organization has enabled "block consumption until quota is distributed" and you haven't received a quota, using AI is blocked; contact the administrator to distribute one, see [Member Credits Quota Management](https://docs.maiagent.ai/maiagent-user-guide/en/others/credits/member-credit-quota.md#new-member-default-quota).

### I log in after joining the organization but see "No Access"? <a href="#faq-no-access" id="faq-no-access"></a>

You are already in the organization, but the administrator hasn't enabled any features for your role yet. For what you can do on this page and what to ask the administrator to do, see [How to Log In to the Platform: Seeing the "No Access" page after logging in?](https://docs.maiagent.ai/maiagent-user-guide/en/start/login.md#faq-no-access).

## Further Reading <a href="#further-reading" id="further-reading"></a>

* [How to Log In to the Platform](https://docs.maiagent.ai/maiagent-user-guide/en/start/login.md)
* [Forgot Password](https://docs.maiagent.ai/maiagent-user-guide/en/start/forget-password.md)
* [Personal Account Settings](https://docs.maiagent.ai/maiagent-user-guide/en/start/profile.md)
* [Member Management (Administrators)](https://docs.maiagent.ai/maiagent-user-guide/en/org/overview/member.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.maiagent.ai/maiagent-user-guide/en/start/invitation.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
