# Invite team members

Invite someone to your admin panel, choose their role, and manage invitations until they accept.

Audience: dealer-managers
Availability: available
Canonical source: https://rooftoprv.com/docs/invite-team-members

Invite a coworker to your admin panel by email. You choose their role up front. Until they accept, you can change the role, resend the invite, or cancel it.

## Before you start

- You need the **View team** permission to see the **Team** page.
- To send, resend, edit, or revoke invites, you need the **Invite members** permission.
- To change the role on an invite, you need the **Assign roles** permission.
- The role you want to give them must already exist.

## Send an invite

1. Select **Admin** in the main menu.
   The **Team** page opens.
2. Select **Invite member**.
3. Enter their **First name** and **Last name**.
4. Enter their **Email address**.
5. Choose a **Role**.
6. Optional: under **Locations (optional)**, select each location they work at.
   This list appears only when your dealership has locations set up and you have the **Assign roles** permission.
7. Select **Send invitation**.
   You see **Invitation sent!** They get an email inviting them to join your team. The email names the role they'll have.

The invite now appears under **Pending invitations** on the same page. Until they accept, they aren't in the main team list. You can already assign them leads and tasks.

## Check on pending invites

**Pending invitations** lists everyone who hasn't accepted yet. An invite link works for 7 days. The **Status** column shows one of these:

| Status | What it means |
|---|---|
| **Invited** | The invite email was sent and the link still works. **Expires** shows how much time is left. If they say they never got it, use **Copy link**. |
| **Expired** | The link stopped working. Select **Regenerate** to send a new one. |
| **Not sent** | The invite exists but no email has gone out yet. Select **Send invite** to email it. |

To act on an invite, select the menu at the end of its row.

## Change the role on an invite

You can change the role before they accept. They join with whatever role the invite has when they accept it.

1. In **Pending invitations**, open the menu on their row.
2. Select **Change role**.
3. Choose the new **Role**.
4. Select **Save role**.
   You see **Role updated**, and the **Role** column shows the new role.

The email you already sent still names the old role. To send them an email with the new role, select **Resend** on the same row.

You can't change the locations on a pending invite. Change them on the **Team** page after they accept.

## Resend an invite or send a new one

> **Warning:** They get a new email. Any link you sent or copied before stops working, so tell them to use the newest one.

1. Open the menu on their row.
2. Select the option it shows:
   - **Resend** for an invite that hasn't expired.
   - **Regenerate** for an expired invite.
   - **Send invite** for an invite that was never emailed.

   You see **Invite resent**, or **New invite sent** for an expired or unsent invite. The new email has a link that works for 7 days.

## Fix a name or email on an invite

> **Warning:** Changing the email turns off the old invite link. If the invite was already emailed, a new one goes to the new address right away.

1. Open the menu on their row.
2. Select **Edit name or email**.
3. Change **First name**, **Last name**, or **Email address**.
4. Select **Save**.

## Share the link yourself

Use this if the email doesn't reach them. **Copy link** appears only while the invite hasn't expired.

1. Open the menu on their row.
2. Select **Copy link**.
3. Send the link to them another way, such as a text message.

## Revoke an invite

> **Warning:** Revoking can't be undone. The link stops working right away, and anything you assigned to them stays with an inactive person. To let them join later, send a new invite.

1. Open the menu on their row.
2. Select **Revoke**.
3. Confirm.
   The invite leaves the list.

## What happens next

When they open the link, they see your team name and their details. They can set a password, or skip it and sign in later with a link sent to their email. A password needs at least 8 characters, with an uppercase letter, a lowercase letter, and a number.

Then they select **Accept invite**. They land in your admin panel with the role and locations from the invite.

## Troubleshooting

**"No roles available. Please create a role first."**
Your team has no roles yet, so the invite form has no **Role** field. Sending shows this message. Create a role first.

**"This person already has a pending invitation."**
They already have an invite that hasn't been accepted. Find them under **Pending invitations** and resend it, or change the role there.

**"This email is already a team member."**
They already have an active account on your team. To change what they can do, edit their role on the **Team** page instead.

**They say the link says "Invitation expired."**
Links last 7 days. Open the menu on their row and select **Regenerate**.

**They say the link isn't valid.**
They're probably using an older email. Each resend replaces the link. Ask them to use the newest one, or select **Copy link** and send it to them yourself.

**I don't see Copy link, Resend, or Revoke.**
Those, and **Edit name or email**, need the **Invite members** permission. With only **Assign roles**, you see **Change role** and nothing else.
