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

# Users and invites

> Invite staff one at a time or in bulk, resend invites, send password resets, manage access requests, and delete or restore users in Field Ops.

Manage your team from **Settings → Company → Users**. The page is titled **Admin · Users** and has three parts, top to bottom:

1. **Access Requests**: people asking to open a page they're blocked from (Admins and the Owner only, and only when there's a request waiting).
2. **Pending Invitations**: invites that haven't been accepted yet.
3. **The roster**: everyone on the team, with their role and last login.

Only an **Admin** or the **Owner** can invite, assign roles, change status, or delete someone. Everyone else who can open Users sees it view-only, with this note:

> You can view, but only admins can invite, assign roles, or change status.

> [!NOTE]
>
> A company can have more than one Owner. Everyone who's an Owner shows as **Owner** on the roster, and each Owner can manage everyone on the team, including the other Owners.

Across the top you'll find **Manage permission sets** (opens the role editor), **Bulk invite**, and **Invite user**.

## Invite a user

**1. Open the form**

In **Settings → Company → Users**, select **Invite user**.

**2. Fill it in**

* **Email** is required.
* **Full name (optional)**.
* **Role** starts on **Door Expert**.
* **Environment** starts on **Sandbox only**. You can also pick **Production only** or **Both**.
* **Note (optional)** is an internal note about the invite. The invitee doesn't see it.

**3. Create it**

Select **Create invitation**. It shows **Creating…** while it saves.

**4. Check that it was emailed**

Field Ops emails the person a set-your-password invite right away. You'll see **Invitation emailed to** their address, and the invite link still shows (**expires in 14 days**) in case you want to send it yourself too. Select **Done** when you're finished.

![Invite a user form with Email, Full name, Role, Environment and Note fields](https://mintcdn.com/yournewdoorcom/fD1O1AD2SaCSmiCe/images/field-ops/users-invite-form-environment.png?fit=max\&auto=format\&n=fD1O1AD2SaCSmiCe\&q=85\&s=7829c52d7aa8fa01b7e42e79245d94a0)

Invite a user, with Environment and Note (example data)

![Invitation created message with the invite link, Copy link and Done buttons](https://mintcdn.com/yournewdoorcom/fD1O1AD2SaCSmiCe/images/field-ops/users-invite-link-created.png?fit=max\&auto=format\&n=fD1O1AD2SaCSmiCe\&q=85\&s=7b5c6a4ed674f99b2d556072764e5ae4)

The invite link after Create invitation (example data)

> [!NOTE]
>
> **Create invitation** sends the same set-your-password email that **Resend invite** sends. Before that, creating an invite never emailed anyone, so if you invited someone before then and they never got an email, use [Resend invite](#resend-an-invite) or send them the link.
>
> If you see **Invitation created. Copy the link below.** instead, the email didn't go out. The invite is still pending and the link works, so select **Copy link** and send it yourself, or try **Create invitation** again for the same email.

### If the invite doesn't go through

| Message | What to do |
| - | - |
| **Enter a valid email.** | Fix the email address. |
| **Pick a role from the list.** | Choose a role. |
| **Only the Owner can invite an admin.** | Ask the Owner to send it. |
| **An account already exists for that email. Edit the person on Users.** | They're already on the team. Edit their row instead. |
| **That email belongs to a deleted user. Restore them from Users → Show deleted instead of inviting.** | Select **Restore** in the form, or restore them from the roster. See [Delete and restore](#delete-and-restore-a-user). |
| **There's already a pending invite for that email.** | Use the invite that's already out, or revoke it first. |
| **Invite installers from Team (or Users add) with a market. Email invite has no market picker.** | Invite the installer from [Team and invites](https://help.yournewdoor.com/guides/settings-users.md#inviting-teammates), where you pick their market. |

If the same email already has a pending invite that hasn't expired, **Create invitation** refreshes it instead of making a second one: the old link stops working, a new 14-day link is made with the role, environment and note you just picked, and the email goes out again. If an older invite for the same email has expired, it's revoked automatically when you send the new one.

> [!NOTE]
>
> Test and QA accounts only get invite emails at `@ynd.test` addresses, the same as **Resend invite**. For other addresses, no email is sent and you'll get the link to copy instead.

## Bulk invite

Use **Bulk invite** to add several people at once.

**1. Paste the list**

Select **Bulk invite** and paste one person per line as `name, email, role`, for example `Jane Doe, jane@example.com, Door Expert`. Commas or tabs both work, and a CSV header row is okay.

**2. Pick the environment**

**Environment (applies to all)** sets the same environment for everyone on the list.

**3. Send**

The form shows **Ready to invite** and the count. Select **Send invitations**.

**4. Share the links**

Each row shows **Copy invite link**, or the reason it failed. **Copy all links** copies every link at once.

![Bulk invite users form with two example lines and the Environment list](https://mintcdn.com/yournewdoorcom/fD1O1AD2SaCSmiCe/images/field-ops/users-bulk-invite.png?fit=max\&auto=format\&n=fD1O1AD2SaCSmiCe\&q=85\&s=988c2f63baee78dbe729ff2e2498b3b2)

Bulk invite users (example data)

If some rows fail you'll see how many were created and how many failed. Fix those lines and send them again. Bulk invite can't create an Owner or an Installer. An Installer line fails with **"Invite installers from Team (or Users add) with a market. Email invite has no market picker."** Invite installers from [Team and invites](https://help.yournewdoor.com/guides/settings-users.md#inviting-teammates) instead.

## Roles you can choose

The roles, in the order they appear:

| Role | Notes |
| - | - |
| **Door Expert** | The default choice. |
| **Project Manager** | Shows as **PM** on the staff roster. |
| **Design Concierge** | |
| **Reconciler** | Can be assigned, but doesn't open any part of Field Ops yet. |
| **Manager** | Can view Users and pending invites but can't invite. |
| **Executive** | Can be assigned, but stays view-only. |
| **CSR** | Can view Users but can't invite. |
| **Dispatcher** | |
| **Admin** | Only the **Owner** can invite someone as Admin or give them Admin. |

> [!NOTE]
>
> The Owner role is never offered on the invite form. **Installer** isn't offered here either, because an installer needs a market. Invite installers from [Team and invites](https://help.yournewdoor.com/guides/settings-users.md#inviting-teammates).

## Pending invitations

**Pending Invitations** lists every invite that hasn't been accepted, with its **Email**, **Role**, **Env**, **Status**, and when it was sent (Central time). If there are none, you'll see **No pending invitations.**

An Admin or the Owner can select **Revoke** on a pending or expired invite. The link stops working right away and you'll see **Invitation revoked**. Managers can see this list but can't revoke.

## Accepting an invite

When the person opens their link they see **You're invited to YND OS**, with the role, the environment, and the email the invite was sent to.

**1. Sign in or create an account**

They sign in, or create an account, using the **same email the invite was sent to**. Google sign-in works too.

**2. Accept**

They select **Accept invitation**, see **Invitation accepted**, then select **Continue**.

If they're signed in with a different email, they'll see a warning to sign in with the invited email first.

### Creating a new account from the invite

New people can create their account right on the invite page. They pick a password, and Field Ops creates the account, signs them in, and accepts the invite in one go. They see **Invitation accepted** and land on the home page. There's no confirmation email to wait for.

This only works through an invite link. Field Ops still doesn't allow open sign-ups, so someone without an invite can't create an account.

| Message they see | What to do |
| - | - |
| **Use the email address this invitation was sent to.** | Type the email the invite went to. |
| **Password must be at least 8 characters.** | Pick a longer password. |
| **An account already exists for this email. Use “I already have an account” to sign in, or reset your password.** | They already have a login. Sign in instead, or reset the password. If they type their existing password when creating the account, it just signs them in and accepts the invite. |
| **Account creation isn't available right now. Ask your admin for help.** | Something's wrong on our side. Let an admin know. |

> [!NOTE]
>
> Each invite link works once. After it's accepted, the link shows **This invitation was already accepted.**

| Message they see | What it means |
| - | - |
| **This invitation link is invalid.** | The link is wrong or incomplete. Send it again. |
| **This invitation has been revoked.** | Someone revoked it. Send a new invite. |
| **This invitation has expired. Ask your admin to re-send it.** | It's past 14 days. Send a new invite. |
| **This invitation was already accepted.** | They're already in. They can just sign in. |

### If they never finished the invite page

Someone with a pending invite doesn't have to go back to the invite link. They can go to the regular Field Ops sign-in page, type the email the invite was sent to, and use **Email me a sign-in link** or **Forgot password**. The email now goes out (before, nothing was sent until the invite was accepted).

When they sign in from that email, Field Ops finishes the invite for them automatically:

* Their account is created with the **role**, **environment**, employment type and portal from the invite.
* The invite is marked accepted and drops off **Pending Invitations**.
* They're signed in and land in Field Ops.

Their display name starts out as their email address. Edit their row on the roster to give them their real name.

> [!NOTE]
>
> This only works for an invite that's still pending: not expired and not revoked. If the invite has expired or was revoked, no email is sent, so send them a new invite. People who've been switched off or deleted are still refused. The usual limits on sign-in and reset emails haven't changed.

See [Finish your invite from the sign-in page](https://help.yournewdoor.com/guides/settings-users.md#finish-your-invite-from-the-sign-in-page) for the steps you can send them.

## Access requests

When a signed-in person lands on a page they don't have access to, they can type an optional reason and select **Request access from admin**. They'll see **Your request has been sent. An admin will review it shortly.**

Admins and the Owner see the request at the top of Users under **Access Requests**, with the person, the page, their reason (or **No reason given**), and when they asked.

* **Approve** gives that one person access to that page. It's saved as a per-person permission, so their role doesn't change.
* **Deny** turns the request down.

## Per-person permissions

When you edit someone, the **Permissions** section lets you override what their role gives them, one permission at a time: **Inherit role**, **Allow**, or **Deny**. Role grants still apply unless you deny them here. You can't set **Deny** on an Owner, so an Owner never loses access through a per-person override. To change what a whole role can do, use **Manage permission sets** instead.

## The roster

Each person's row shows their role, email, and **Last login** (Central time, or **never** if they haven't signed in). People who've been switched off show an **Inactive** badge.

## Resend an invite

If someone never got their invite email or lost it before signing in, an **Admin** or the **Owner** can send it again from the roster.

**1. Find the person**

In **Settings → Company → Users**, find the person who hasn't signed in yet.

**2. Open the row menu**

Select the **⋯** button at the end of their row.

**3. Resend**

Select **Resend invite**. It shows **Sending…** for a moment, then a message right on the page confirms it, like **Invite sent to** their email **at 3:30 PM CT**. If it didn't go through, the reason shows in the same spot.

There's no confirmation step, and clicking twice only sends one email.

![A Users roster row with its menu open, showing Resend invite](https://mintcdn.com/yournewdoorcom/fD1O1AD2SaCSmiCe/images/field-ops/users-resend-invite-menu.png?fit=max\&auto=format\&n=fD1O1AD2SaCSmiCe\&q=85\&s=0bccbe837b1f0613ab03c0a983149272)

The row menu with Resend invite (example data)

**Resend invite** only shows for people who are active, have an email on file, and haven't set up their login yet. Once someone has signed in, the same spot in the menu shows **Send password reset** instead. See [Send a password reset](#send-a-password-reset).

### Limits

| Limit | Message you'll see |
| - | - |
| One resend per minute | **Wait a minute before resending an invite.** |
| Five resends per day (Central time) | **Invite resend limit reached for today. Try again tomorrow.** |

Every attempt counts toward these limits, even one that didn't go through. If the email can't be sent, you'll see **Couldn't send the invite. Try again in a minute.**

> [!NOTE]
>
> Test and QA accounts only get invite emails at `@ynd.test` addresses. For any other address, the resend is skipped and nothing is sent.

## Send a password reset

An **Admin** or the **Owner** can email a password reset to someone who already has a login, for example when they're locked out or forgot their password.

**1. Open the row menu**

In **Settings → Company → Users**, select **⋯** at the end of the person's row.

**2. Send it**

Select **Send password reset**. It shows **Sending…**, then a message on the page confirms it, like **Password reset sent to** their email **at 3:30 PM CT**.

**3. They pick a new password**

The person gets the same reset email they'd get from **Forgot password** on the sign-in page, and follows the link to choose a new password.

You never see the reset link yourself. It only goes to the person's email. Like resending an invite, there's no confirmation step and a double click only sends once.

**Send password reset** only shows for people who are active, have an email on file, and have already signed in. It follows the same rules as the rest of Users: only Admins and the Owner can send one, and an Admin can't send one to another Admin.

| Message | What it means |
| - | - |
| **Couldn't send the password reset. Try again in a minute.** | The email didn't go out. Wait a minute and try again. |
| **This person hasn't signed in yet. Resend their invite instead.** | They don't have a login yet, so use **Resend invite**. |
| **This person is inactive. Reactivate them before sending a reset.** | Turn them back on first. |
| **This person has no work email.** | Add an email to their profile first. |

Resets sent from Users count toward the same limits as **Forgot password**, so if several were just requested for that person, you may need to wait before sending another.

## Delete and restore a user

Deleting someone removes their access without losing any history. An Admin or the Owner can do it.

**1. Open the row menu**

Select **⋯** on the person's row, then **Delete user**.

**2. Read the warnings**

The dialog explains that they lose access right away, are signed out on every device, and won't show up when you assign work or route calls. Their jobs, calls, notes, payments and reports stay, with their name marked **(deleted)**.

If they have upcoming appointments or open jobs, you'll see a warning with a **See their upcoming work** link so you can reassign it. If they're set to receive calls, deleting turns that off and takes them out of the call rotation.

**3. Confirm**

Type their name exactly. When it shows **Name matches**, select **Delete user**. You'll see **was deleted** with their name.

![Delete user dialog with the warnings and the type-the-name confirmation box](https://mintcdn.com/yournewdoorcom/fD1O1AD2SaCSmiCe/images/field-ops/users-delete-confirm.png?fit=max\&auto=format\&n=fD1O1AD2SaCSmiCe\&q=85\&s=29a63075f301774051b3d6be510a2a4d)

Delete a user, with the type-to-confirm box (example data)

If something goes wrong you'll see **Nothing changed. Try again.**

### When you can't delete someone

| Situation | What happens |
| - | - |
| It's your own account | **You can't delete your own account.** |
| They're the last Admin | **They're the last admin. Make someone else an admin first.** |
| They're the last Owner left | **They're the only owner, so they can't be deleted.** Another Owner can be deleted as long as at least one Owner remains. |
| You're an Admin and they're an Admin | Only the Owner can delete an Admin, so the option doesn't show. |
| You're not an Admin or the Owner | The option doesn't show. |

### Restore someone

Tick **Show deleted** at the bottom of the roster to see the **Deleted** section. Each row shows who deleted the person and when. Select **⋯ → Restore user** to bring them back. Only an Admin or the Owner can restore.

> [!TIP]
>
> If you try to invite someone who was deleted, the invite form offers to restore them instead.

## Related

> [card] [Roles: who can do what](https://help.yournewdoor.com/guides/roles.md)
>
> What each role can open and do.

> [card] [Settings, users and sign-in](https://help.yournewdoor.com/guides/settings-users.md)
>
> Role access and sign-in.

> [card] [Quickstart: admins](https://help.yournewdoor.com/start/admins.md)
>
> Set up your team on day one.


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