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

# Joining a Team

> How to accept a team invitation and set up your account on Surfacd.

When someone invites you to their team, you'll receive an email with a link to join.

## Accepting Your Invitation

1. Check your email for an invitation from Surfacd
2. Click **Accept Invitation** in the email
3. You'll be directed to complete your account setup

<Note>
  Invitation links expire after 7 days. If your link has expired, ask your team admin to resend the invitation.
</Note>

## New Users

If you don't have an account yet:

1. Click the invitation link
2. Create a password for your account
3. Click **Complete Setup**

You'll be logged in automatically and taken to your new team's dashboard.

## Existing Users

If you already have an account:

1. Click the invitation link
2. If you're already logged in, you'll join the team automatically
3. If you're logged out, you'll be prompted to sign in first

Once signed in, you'll be added to the team and can access shared projects.

## Team Roles

Your team admin assigns you a role that determines what you can do:

| Role       | Capabilities                                                         |
| ---------- | -------------------------------------------------------------------- |
| **Owner**  | Full control — manage billing, team settings, and transfer ownership |
| **Admin**  | Manage team settings, invite members, create and edit all projects   |
| **Member** | Create and manage your own projects, view all team projects          |
| **Viewer** | View-only access to all team projects and reports                    |

<Tip>
  Need a different role? Contact your team admin to update your permissions.
</Tip>

## Auto-Provisioning

If your team has auto-provisioning enabled for your email domain, you'll be automatically invited when you first sign in with Google or Microsoft. You'll see a pending invitation on the team selector page — click **Accept** to join.

## Multiple Teams

You can be a member of multiple teams. Switch between teams using the team selector in the navigation sidebar.

## Troubleshooting

<AccordionGroup>
  <Accordion title="Invitation link not working">
    The link may have expired (after 7 days) or already been used. Ask your team admin to resend the invitation from **Settings → Members**.
  </Accordion>

  <Accordion title="Can't see team projects">
    Make sure you've accepted the invitation by clicking the link in your email. If issues persist, contact your team admin.
  </Accordion>

  <Accordion title="Google or Microsoft sign-in failed">
    Return to the sign-in page and try again. OAuth links can expire if the browser tab was left open or the authorization code was already used.
  </Accordion>

  <Accordion title="Need to change your email">
    Contact your team admin to send a new invitation to your preferred email address.
  </Accordion>
</AccordionGroup>