Docs › Team & operations › Team & roles

Set up team & roles

In this guide you invite colleagues, assign roles and control exactly who may see and do what — including brand assignment and optionally mandatory two-factor sign-in.

⏱ approx. 5–10 min · Permission: roles.manage (admin) · Free (up to 3 users) & Paid (unlimited) · As of version 1.1.60

Settings → Team & permissions in The-Y CRM
Settings → Team & permissions — invite, roles and permissions.

Invite members

  1. Open Team & permissions. Settings → Team & permissions.
  2. Invite. "+ Invite": choose email, name and role. The role Agent is already preselected. The person receives an invitation link and sets their own password on first open — so you never share a password.
  3. Choose brands. If you have several brands, you choose under "Brands" which conversations the person sees. The first brand is preselected. If you choose nothing, the person gets the default brand — so they see conversations right away.
  4. Track status. Open invitations appear in the list; you can resend or revoke them. Accepted members show up as active users.
Free is limited to 3 users; on Paid the team size is unlimited. Open invitations count too. It is checked when inviting, creating, accepting and reactivating. Changing a role never changes the count.

Roles & visibility (scope)

Each person has one or more roles. The scope determines whose data (contacts/deals/tickets) they access.

RoleTypically allowedScope
Admineverything — incl. settings, team, billing, integrationsall
SupervisorCRM + analytics for the whole team, approvals (e.g. leave), no operator settingsall / team
Agentedit own contacts/deals, answer ticketsown (or team)

Scope: own (only what's assigned to/owned by me), team (my team), all (the whole tenant). "Owned by me" means: assignee or creator.

Custom roles (since 1.1.60)

Besides the standard roles (Admin, Team lead, Agent, Customer/Portal) you can create your own roles – for example “Doctor”, “Assistant” or “Front desk”.

How: Settings → Team & permissions → Manage roles → “New role”. Start empty or as a copy of an existing role, enter a name and tick what the role may do. For contacts, companies, deals, conversations, tasks, meetings and custom records you also choose whether the permission covers own records only or all.

Important permissions (since 1.1.53)

If you have custom roles with finance permissions but without “Export contacts”, they no longer see the export buttons in Finance since 1.1.53. Grant the permission if needed.

Fine-tune rights per person (overrides)

In addition to the role, you fine-tune individual rights per person — in the member editor, set each right to inherit (from the role), allow or deny.

Deny beats allow. Example: an agent should exceptionally be able to see companies → set the right company.view to "allow". Conversely, block specific actions with "deny".

Rights apply everywhere: menu items are hidden, "new/edit/delete" buttons disappear, and the server checks every action (no bypass via the URL).

Assign brands/workspaces

If you have multiple brands (workspaces), you assign in the member editor under "Brands" which brands a person sees. Agents only see the inboxes of their brands; admin/supervisor see all. That way you cleanly separate multiple customer brands, for example — one bill, multiple brands.

If someone isn't assigned to a brand, the team list shows "no brand". This person sees no conversations, and their inbox explains why. Click "Edit" → Brands and choose at least one brand.

Enforce two-factor sign-in (2FA)

Troubleshooting

The invitation link no longer works

Invitations expire or may have been revoked. Simply resend the invitation in Settings → Team & permissions. (Invitation emails need a configured system mailbox; if none is set, give the person the link directly.)

I can't change my own role

This is intentional: changing your own role/rights is blocked so you can't accidentally lock yourself out. Another admin can change it (multiple admins are equal-rank).

An agent sees too little or too much

This is controlled by the scope (own/team/all) plus the overrides. For "own customers only" → scope own. For targeted exceptions, set individual rights to allow/deny. If the person shows "no brand", assign a brand to them.

I can't invite anyone any more

The user limit is reached. Open invitations count too. Revoke invitations you no longer need under "Pending invitations". Accounts that are already over the limit keep their users; only new invitations are blocked then.

Someone is locked out by 2FA

First sign in with a recovery code. If that's not possible, an admin resets the person's 2FA in Settings → Team & permissions; then they set up 2FA again.

What's next