> For the complete documentation index, see [llms.txt](https://help.getmobly.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.getmobly.com/help-center/account-and-team/how-to-add-users.md).

# How to add users

This article walks through adding users to your Mobly org. **It's admin-only** — you'll need the Mobly Admin role to access the Users tab in the Hub.

For bulk adds (more than a handful of users at once), see [How to bulk upload users](/help-center/account-and-team/how-to-bulk-upload-users.md).

## The two ways to add a user

From the Hub Users tab, the **Add User** button opens a dropdown:

* **New User** — fill out a form in the Hub. Best for adding one or a few users.
* **Import from CSV** — upload a spreadsheet. Best for adding many users at once.

## Add a new user from the form

1. In the Hub, go to **Users** and click **Add User → New User**.

   ![](//d33v4339jhl8k0.cloudfront.net/docs/assets/67f00b47b96c282fea91b6f6/images/69b320239c0a2d7ca870f4ff/file-B7cs8Tx47u.png)
2. Fill in the required fields: **First Name**, **Last Name**, **Email**.

   Optional fields help your reporting later: Phone Number, Address, Job Title, Company Name, LinkedIn, Facebook, X (Twitter).

   ![](//d33v4339jhl8k0.cloudfront.net/docs/assets/67f00b47b96c282fea91b6f6/images/69b3211ba280f057e03025ed/file-5G669iW1xv.png)
3. Toggle **Send Welcome Email** to send the new user a sign-in email immediately. If you leave it off, the user is created but won't get an email — you can trigger one later from the Users table.
4. Click **Save**.

New users are created as **Client** by default. If someone needs to be a Mobly Admin instead, contact your CSM after creating them — see [User roles in Mobly](/help-center/account-and-team/user-roles.md).

## What the new user sees

When you send the welcome email, the user gets an email from `support@getmobly.com` with a **6-digit PIN code** and a link to complete setup. Their flow:

1. Click the link in the email.
2. Enter the 6-digit PIN.
3. Set a password (or sign in with SSO if your org has it configured).
4. They're in.

If they don't receive the email within a few minutes, ask them to check spam. If still nothing, you can resend from the Users table — click into the user and use **Resend Welcome Email**.

## SSO orgs — auto-enrollment

If your org has SAML/SSO configured, users with a matching email domain can sign in directly — Mobly auto-creates the user on first login. You don't need to add them manually for SSO to work.

You can still pre-add users via this flow if you want to assign them event access before they sign in for the first time.

## Related articles

* [How to bulk upload users](/help-center/account-and-team/how-to-bulk-upload-users.md) — CSV upload for many users at once
* [User roles in Mobly](/help-center/account-and-team/user-roles.md) — what each role can do
* [How to assign users to an event](/help-center/the-hub/managing-events/how-to-assign-users-to-an-event.md)
* [Having login issues?](/help-center/account-and-team/having-login-issues.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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.getmobly.com/help-center/account-and-team/how-to-add-users.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.