# How to invite users to an Enterprise domain workgroup, via a collaborative Enterprise domain account

The steps below outline the process for inviting users to an Enterprise domain workgroup, via an account on a Collaborative Enterprise domain. Users to be invited ***must*** create their account prior to being invited. If a user email is invited before the account is created, there will be no error message and a confirmation email will be sent to the email address specified. However, because no account existed with that email on the domain specified prior to the invite being sent, there will be no updates to the database, even if the account is created after the fact. The user must create an account and **request the domain/workgroup admin re-invite them**.

Steps:

1. (Domain admin) Log into domain at [https://.login.illumina.com/](https://github.com/illumina-swi/illumina-knowledge/blob/master/docs/Software/Cloud-Software/Reference_Material/https:/%3Cdomain%3E.login.illumina.com)
2. Open IAM Admin Console:
   1. ![](/files/h2xjEKYGwGd1ImsQ7C9u)
3. From the **DOMAIN** tab, select **COLLABORATION MANAGEMENT**.
4. Enter the domain of the collaborative enterprise account(s) to be invited and click the + icon.
   1\.

   ```
   ![](/files/aKfZuSnRRlYS8cM8Ladw)
   ```

   2\. A confirmation message will appear, verifying the domain has been successfully added.

   1. ![](/files/Lz55xy0C7FTTbzx5CrHF)
   2. If the domain does not exist, an error message will appear in which case the user will need to check and confirm the domain string entered.
      1. ![](/files/hTKVRBeVp9P8Wpn2a3gM)
5. (Domain or Workgroup admin) From the **WORKGROUPS** tab, select the Workgroup to which users are to be invited. *Note: workgroup must be a Collaborative workgroup, which can only be set during workgroup creation (see* [this article](https://knowledge.illumina.com/software/basespace-sequence-hub/software-basespace-sequence-hub-reference_material-list/000001666?utm_source=agent\&utm_medium=email\&utm_campaign=kb)*).*
   1. ![](/files/9uoEPWy1ijj5MMUhA0SS)
6. Select **USERS** to invite regular users to the Workgroup (default tab is ADMINS which is used to invite users to become Workgroup admins).
   1. ![](/files/2sandy2TAA8fLKKmuG1p)
7. Select **Invite** and enter desired email address(es) (one address per line) and check the button for "Invite via collaborative enterprise".
   1. ![](/files/9dtiFHJCan8MykrrfKUG)
8. Select **Grant Access**.

Invited users can now log in via their enterprise domain (eg, <https://ilmn.login.illumina.com> from example above) and navigate to the appropriate application (eg, BSSH) where they can then select the workgroup to which they have been added.

\
\
\ <br>

|                                                                                                                                                                                                                                                                                                                                                                 |
| :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |
| *For any feedback or questions regarding this article (Illumina Knowledge Article #5878), contact Illumina Technical Support* [*techsupport@illumina.com*](mailto:techsupport@illumina.com?subject=Question%2FFeedback%20Regarding%20Illumina%20Knowledge%20Article%20#000005878%20-%20Software%20\&body=Dear%20Illumina%20Technical%20Support,%0D%0A%0D%0A)*.* |


---

# 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://knowledge.illumina.com/software/cloud-software/software-cloud-software-reference_material-list/000005878.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.