# Adding users

There are several ways to add users to groups or generate their accounts. These are outlined below.

### Adding existing users

{% content-ref url="/pages/5mlW46Br0j5pIgPNtROU" %}
[Adding & inviting users](/doc/users-and-groups/creating-groups/adding-and-inviting-users.md)
{% endcontent-ref %}

You can add users who already have accounts to new user groups. If you have a list of emails or a CSV containing new, existing, or unknown users, you can use the generate or invite functions outlined below.

### Generating accounts

{% content-ref url="/pages/taVtyDSNHj2hS01H2eGg" %}
[Generating user accounts](/doc/users-and-groups/creating-groups/generating-user-accounts.md)
{% endcontent-ref %}

If you know which users you want to create accounts for and do not need any additional information about them, this is the most efficient method for adding new users. This can be done one account at a time, or in bulk via CSV.

Once this process is completed, users will have attempts generated for any published / active exams set to the group, as well as for any active assignments set to the group.

### Inviting users

{% content-ref url="/pages/5mlW46Br0j5pIgPNtROU" %}
[Adding & inviting users](/doc/users-and-groups/creating-groups/adding-and-inviting-users.md)
{% endcontent-ref %}

If you need to gather information about users during the registration process, use invites. This can be done with email addresses only, or in bulk with names and other known attributes via CSV. Users will not have accounts or linked exams or assignments created until they complete the registration process.

Remember to create any custom user attributes required at registration. More on attributes here: [Custom attributes](https://academy.synap.ac/doc/portal-settings/data-management/attributes) (**Not available on Standard plans**).

### User group sharing links

{% content-ref url="/pages/FUHh23MvROG8hQME1zCr" %}
[User group sharing links](/doc/users-and-groups/creating-groups/user-group-sharing-links.md)
{% endcontent-ref %}

If you want users to register their own accounts and be auto-added to a specific group, use sharing links. This is useful if you do not know the users' details.

These can be made private if you only want existing users to be able to join the user group.

### Exam vouchers

{% content-ref url="/pages/qoftxx9nGK298psKfXyS" %}
[Exam vouchers](/doc/exams/create-and-manage-exams/5.-share/exam-vouchers.md)
{% endcontent-ref %}

**(Business plans only):** If you want users to be registered directly for a specific exam but do not know their details, use exam vouchers. This method can be used for new or existing users. It can also be used to give a user another attempt at an exam they have already taken.

### SSO

{% content-ref url="/pages/EOZhRWkE5tyIyWERzEyf" %}
[SSO Authentication](/doc/portal-settings/portal-settings/sso-authentication.md)
{% endcontent-ref %}

**(Business plans only):** If you already have an existing user database and users have logins there, you can connect those to Synap through SSO. This eliminates the need for users to remember and manage multiple usernames and passwords.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://academy.synap.ac/doc/users-and-groups/creating-groups/adding-users.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
