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

# Add a user

> How to add a user in the SuperOffice Developer Portal.

You need a SuperID user account to access the Developer Portal. A **portal user** (user for short) belongs to one or more [partners][1] and has a set of [permissions][2].

[1]: ../about#partner

[2]: ../partner/manage-permissions

You can view the users already added on your partner page.

![Users page -screenshot][img1]

This task requires **User management** permission.

<Tabs>
  <Tab title="Partner Admin">
    ## Who can I add?

    You can add any known user by name or email address that shares one or more tenants with you **in production**. You can't add users that don't share a tenant with you. If you want to add a user that doesn't share a tenant with you, you must first add the user to your tenant by creating a new user in the target SuperOffice instance [Settings and maintenance][3].

    * If it matches an existing [SuperID][2] user account, select and add the user to the partner. If you know this user is a SuperOffice CRM Online user, make sure you use the correct UPN - `firstname@company.com` versus `firstname.lastname@company.com`
    * If the search results are empty, ensure the **active user** belongs to at least one of your shared tenants **in production**. If not, you can't add them to your partner.

    ## How to

    1. In the Developer Portal, go to your partner page.

    2. Select **Users** from the left menu.

    3. Click **Add User** button.

       ![Add use -screenshot][img6]

    4. Enter a valid name or email address, then select the user from the list.

       ![Find user by email in the SuperOffice Developer Portal -screenshot][img7]

    5. Selected the user from the list, then click **Add**.

    6. The user is added to the Partner Users collection.

    7. You can now [assign permissions][1].
  </Tab>

  <Tab title="DevPortal Admins">
    ## Who can I add?

    You can assign a known user or create a new one. In both cases, you look up an email address.

    * If it matches an existing [SuperID][2] user account **in production**, all you have to do is to assign it to the partner. If you know this user is a SuperOffice CRM Online user, make sure you use the correct UPN - `firstname@company.com` versus `firstname.lastname@company.com`
    * If the address is unknown, you can fill in a form to create a new user. This person becomes both a SuperID user and a portal user.

    ## How to

    1. In the Developer Portal, go to your partner page.

    2. Select **Users** from the left menu.

    3. Click **Create User**.

    4. Enter a valid email address and click **Find user by email**.

       ![Find user by email in the SuperOffice Developer Portal -screenshot][img2]

    5. Either assign a known user or create a new one.

       For known SuperID users, click **Assign to Partner**.

       ![Assign User to Partner dialog -screenshot][img5]

       If the user is unknown:

       1. Click **Create User**.

          ![Create user button in the SuperOffice Developer Portal -screenshot][img3]

       2. Fill in the form.

          ![Create user form in the SuperOffice Developer Portal -screenshot][img4]

       3. Click **Create**.

    6. You can now [assign permissions][1].
  </Tab>
</Tabs>

<Tip>
  For details about each field, see the [user settings reference section](../user-settings).
</Tip>

[1]: ./manage-permissions

[2]: ../../online/identity/superid/index

[3]: ../../admin/user-management/add-associate

[img1]: /media/loc/en/developer-portal/users.png

[img2]: /media/loc/en/developer-portal/search-user.png

[img3]: /media/loc/en/developer-portal/create-user.png

[img4]: /media/loc/en/developer-portal/create-user-form.png

[img5]: /media/loc/en/developer-portal/assign-user-to-partner.png

[img6]: /media/loc/en/developer-portal/add-user-button.png

[img7]: /media/loc/en/developer-portal/type-user-email.png


## Related topics

- [Add users](/en/admin/user-management/add-associate.md)
- [Users](/en/admin/user-management/index.md)
- [Add user-defined field](/en/custom-objects/admin/add-udef.md)
- [Add a user in the Admin client](/en/online/identity/user/add-user-in-admin-client.md)
- [Add Chat Topic User Agent](/en/api/reference/restful/rest/chattopic/add-chat-topic-user-agent.md)