# Add users and teams to your apps via a business hub

{% hint style="info" %}
**Who can use this feature?**

* Business hub **Owners**
* Only supported using the Cerby web app
  {% endhint %}

As a business hub **Owner**, you can add users to your external seat-based and paid social apps through Cerby.

The process of adding users involves sharing the business hub integration with one or multiple users and teams, and assigning roles both in the integration and in the external app, including assets if supported.

{% hint style="danger" %}
**IMPORTANT:** To start protecting and managing user access from Cerby, the new users must accept the invitation and join the external app. For instructions, read the article [Join your external app and set up your business hub access](https://help.cerby.com/cerby-web-app/business-hubs/join-your-external-app-and-set-up-your-business-hub-access).
{% endhint %}

To add a user to your app via a business hub, you must complete the following steps:

1. Log in to your corresponding [Cerby](https://app.cerby.com/) workspace.
2. Select the **Business Hubs** option from the left menu. The **Business Hubs** page is displayed.
3. Click the **More options** (...) icon of the corresponding business hub card. A drop-down menu is displayed.
4. Select the **Settings** option from the menu. The business hub details page is displayed with the **Settings** tab activated.
5. Click the **Share** button located at the top-right section of the page. The **Share Access** dialog box is displayed.
6. Enter the name or email address of the user or the name of the team in the search bar. The users or teams that match the name or email address are displayed on a list below the search bar.
7. Select the corresponding user or team from the list.
8. Repeat steps 6 and 7 to invite multiple users and teams.
9. Select the corresponding role of the users and teams on the business hub from the role drop-down menu:
   * **Owner** : This role enables sharing access and managing the app settings in Cerby.
   * **Collaborator** : This role enables only logging in to the app.
10. Click the **Next** button. The **Define Access** dialog box is displayed.
11. Select the option of the corresponding access level of the users on the app:

* \*\*Invite user to : \*\*It means users can join the app with an assigned seat and manage the app settings in Cerby.
* **Share only business hub in Cerby:** It means users can access and manage the app settings in Cerby without assigning a seat. ​**NOTE:** The **Share only business hub in Cerby** access level is only enabled when selecting Owner as the user’s role.

12. Click the **Next** button. The **Define App Role** dialog box is displayed.
13. Select the corresponding access role of the users and teams from the **Application Role** list.\
    **NOTE:** Access roles are different depending on the app’s native roles and permissions.
14. (Optional) Assign the assets to share with the users and teams by completing the following steps:
15. Click the **Next** button. The **Assign assets** dialog box is displayed.
16. Select the assets you want to grant access to the users and teams.
17. Select the role options you want to assign to the users and teams:
    * **Partial access:** It means users can only perform the selected actions on the asset. ​**NOTE:** The actions that users and teams can perform on an asset differ depending on the app.
    * **Full access:** It means users can perform all the supported actions on the asset.
18. Click the **Share** button. The dialog box closes, and a success message box is displayed. The new users and teams are displayed in the table in the **User Overview** section.

Cerby triggers an automated task to send invites via email to the users to set up their account to join the app and connect their user account to Cerby.

Now you are done.

{% hint style="info" %}
**NOTE:** If the invitation fails, you’ll see an **Invite failed** status next to the user. You can resend the invitation manually. For detailed instructions, read the article [Troubleshooting: Add users to your app manually](https://help.cerby.com/tips-and-troubleshooting/troubleshooting/business-hubs/troubleshooting-business-hubs#h-fe825e748a).
{% endhint %}


---

# 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://help.cerby.com/setup-and-admin/business-hubs/managing-users-and-assets-via-a-business-hub/add-users-and-teams-to-your-apps-via-a-business-hub.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.
