Quick answer
A workspace admin adds users in Administration, under Users. The account can be local or single sign-on, and you give it a role such as Developer. The Activity feed then records a Create or Invite entry for the new user. You need the user:manage permission.
Steps
- Use an account that holds the
user:managepermission, such as a SuperAdmin. If you see no Administration item in the sidebar, you do not have it. See why Administration is missing. - Click Administration, then open Users, where your workspace's accounts are managed.
- Start a new user with the add control on that page.
- Enter the person's name and email, then choose whether the account is local or comes from single sign-on, which depends on how your company signs in.
- Pick a role: Developer is built in, and any custom role your admins made is also on offer.
- Save the form, and tell the new person which address to use, because they sign in with the account type you chose for them.
- Open Activity. Search for the person's name to see the entry.
The Administration screens were not part of the pages we reviewed. Button names may differ a little from the words used here.
Good to know
The API does the same job. A call to POST /api/users creates a user, either local or single sign-on, and it needs the user:manage permission to work.
| Activity entry | What it tells you |
|---|---|
| Create · User | Shows the user, the roles given and the account source, such as local |
| Invite · User | Shows whether an email went out (Emailed true or false) |
| Update · User | Shows roles added later |
- Your plan caps how many users a workspace can hold. Look at Settings → Plan & usage.
- Choose the narrowest role that lets the person work, which is least privilege in practice and keeps later reviews short.
- A teammate who cannot be picked as an assignee may lack the right permissions. See that fix.
Next, read how to create a custom role or how to remove a user.
Related questions
- How do I create a custom role with specific permissions?
- How do I remove a user from my workspace?
- How do I see each user's role and team grants?
- Which roles come built in?
- How do I create a team?
Full tutorial
Cyberlop API tokens and permissions: how to issue and limit them
Step-by-step, with annotated screenshots.
Updated · Back to the help centre
Still stuck?
Tell us what you see on screen and an engineer will help you sort it out.