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

# Teams

> Organize account members and restrict analytics visibility with teams.

Teams are account-scoped groups that control **who sees which resources in the dashboard**. They are separate from account membership (users on an account) and from roles (what actions a user can perform).

## Teams vs members vs roles

| Concept     | Purpose                                                   |
| ----------- | --------------------------------------------------------- |
| **Members** | Users who belong to the account (`users_by_accounts`)     |
| **Teams**   | Organizational units for analytics scoping                |
| **Roles**   | Permissions (`read`, `write`, `delete`) per resource area |

A member can belong to multiple teams. A member with **no team assignments** (and who is not ADMIN or owner) only sees resources with empty `team_ids`.

## Entity team picker

When creating or editing a resource, use the **Teams** field to assign visibility:

* Select one or more teams to restrict analytics to those members.
* Choose **No teams** to leave `team_ids` empty so everyone can see the resource.

<Frame caption="Team resource picker">
  <img src="https://mintcdn.com/trd/jUtW96NzARK4xM7O/images/team-resource-picker.webp?fit=max&auto=format&n=jUtW96NzARK4xM7O&q=85&s=2064e71cc3c3120745f352135e953e13" width="2908" height="1478" data-path="images/team-resource-picker.webp" />
</Frame>

The picker lists only teams the current user belongs to (except ADMIN users, who see all teams).

## Dashboard navigation

| Section     | Path                    | Actions                                        |
| ----------- | ----------------------- | ---------------------------------------------- |
| Members     | `/settings/team`        | Invite, assign roles and teams, remove members |
| Teams       | `/settings/teams`       | Create, edit, view team members                |
| Roles       | `/settings/roles`       | Define custom permission sets                  |
| Invitations | `/settings/invitations` | Track pending invites                          |

<Frame caption="Teams list">
  <img src="https://mintcdn.com/trd/jUtW96NzARK4xM7O/images/teams-list.webp?fit=max&auto=format&n=jUtW96NzARK4xM7O&q=85&s=a0ebcee8b4580ab2c3000909e4f1cfbf" width="2932" height="1452" data-path="images/teams-list.webp" />
</Frame>

## Permissions

| Action                           | Requirement                          |
| -------------------------------- | ------------------------------------ |
| View members, teams, invitations | Account member                       |
| Invite members                   | `settings:write`                     |
| Create / edit / delete teams     | `settings:write` / `settings:delete` |
| Assign member teams              | `settings:write`                     |
| Remove members                   | `settings:delete`                    |

The built-in **ADMIN** role has all permissions. Custom roles define per-resource access across 30+ areas (campaigns, rewards, marketing automation, and more).

## Invitations

Member invitations expire after **24 hours**. Recipients accept via `/auth/accept-invitation?id=…` after signing in with the invited email.

## Related documentation

* [Manage teams](/guides/manage-teams) — step-by-step dashboard guide