> For the complete documentation index, see [llms.txt](https://help.cerby.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.cerby.com/setup-and-admin/business-hubs/managing-your-business-hubs/view-the-status-of-your-business-hub-integration.md).

# View the status of your business hub integration

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

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

As a business hub **Owner** or **Manager**, you can view the status of your business hub integration directly on the **Business Hubs** page.

When you connect the first business hub in your workspace for an external app, Cerby runs a validation to confirm that the integration is correctly configured and working in your environment. After validation, the integration status might change over time due to account misconfigurations or changes in the external app.

In any case, viewing the status helps you quickly determine if the integration is working correctly, if it requires your attention, or if Cerby is actively addressing an issue.

To view the status of your business hub integration, you must complete the following steps:

1. Log in to your [Cerby](https://app.cerby.com/) workspace.
2. Select the **Business Hubs** option from the left menu. The **Business Hubs** page is displayed with a table of integrations, as shown in **Figure 1.**

   <figure><img src="/files/zPhdeemJnuilfCw6Yl5c" alt="Screenshot of the Cerby web app dashboard. The Business Hubs page is displayed with a table of connected integrations."><figcaption><p>Figure 1. Business Hubs page in the Cerby web app dashboard</p></figcaption></figure>

The integration status is displayed under the **Status** column, with the following as the possible statuses:

* **Under validation:** The business hub has been successfully connected to an external app, and Cerby is currently validating if the integration works correctly in your environment. ​

  <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>NOTE:</strong> This status appears while Cerby completes the validation for a business hub. After validation is completed, subsequent business hubs for the same app will not enter this status.</p></div>
* **Under review by Cerby:** Cerby is currently reviewing and addressing issues identified during validation.
* **Action required:** One or more integration flags are active on this integration and are preventing Cerby from completing automation jobs. The integration **Owner** or **Manager** must address each flagged issue and clear the flags. For more information, read the section [Integration flags](#integration-flags) below.
* **Requires sync:** Cerby has detected that the data for this business hub is outdated. The integration **Owner** or **Manager** must perform a manual data sync.
* **Sync failed:** Cerby attempted to sync data from the external app but the operation failed. The integration **Owner** or **Manager** must review the issue and attempt the sync again.
* **Healthy:** The business hub integration is working correctly, and the data for this business hub is up to date.

## Integration flags

Integration flags are configuration issues detected on a business hub or its associated service account that prevent automation jobs from completing. When one or more flags are active, the business hub shows the **Action required** status.

Unlike general status indicators, each integration flag includes a message with specific context about the issue and the steps required to resolve it. After you address the issue, you can clear the flag yourself without contacting support.

The following are the possible integration flags:

* **Seat limit reached:** The external app does not have enough available licenses or seats. Cerby cannot add users or update their roles until additional seats are available.
* **Invalid Business ID:** The Business ID configured for this integration is incorrect, invalid, or does not match the expected account in the external app. Cerby cannot sync data, add, update, or remove users until the Business ID is corrected.
* **Insufficient permissions:** The associated service account does not have the required permissions in the external app to perform the requested actions. Cerby cannot sync data, add, update, or remove users until the permissions are granted.
* **Service suspended:** The subscription for the external app is inactive or deactivated. No automation jobs can run until the subscription is reactivated.
* **Configuration required:** The integration requires additional configuration not covered by other flags. Review the detail message for specific instructions.
* **Incorrect credentials:** The last automation could not complete because the service account has an incorrect username or password. Verify and update the service account credentials in Cerby.
* **MFA not managed:** The service account has MFA turned on but Cerby does not manage it. Configure Cerby-managed MFA.

### View and clear an integration flag

To view and clear an integration flag on your business hub, you must complete the following steps from the **Business Hubs** page:

1. Click the business hub with the **Action required** status. A side panel is displayed to the right with the **Overview** tab active, as shown in **Figure 2**.

   <figure><img src="/files/LxCqoL70teMi5uqEGTal" alt="Screenshot of the Cerby web app dashboard. A side panel is displayed to the right with the details of the business hub and a banner with the tasks that require attention"><figcaption><p>Figure 2. Integration flag in the Cerby web app dashboard</p></figcaption></figure>
2. Select the **Issues** tab. All detected issues are displayed with their detail messages to understand what action is required.
3. Follow the instructions to solve each issue.
4. After completing the required actions, clear the flag manually.

{% hint style="info" %}
**NOTE:** If you are unable to resolve an issue after following the instructions provided by the integration flag, contact our Support team via email at <support@cerby.com> or through the help chat in the Cerby web app dashboard.
{% endhint %}

Now you are done.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://help.cerby.com/setup-and-admin/business-hubs/managing-your-business-hubs/view-the-status-of-your-business-hub-integration.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.