> For the complete documentation index, see [llms.txt](https://brightwind.gitbook.io/brighthub-user-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://brightwind.gitbook.io/brighthub-user-docs/reference-user-manual/brighthub-organisations/organisation-data-monitoring.md). # Organisation - Data Monitoring On the 'Data Monitoring' tab a data retrieval method can be configured for your organisation so that data can be automatically retrieved to BrightHub. {% hint style="info" %} This organisation must have billing enabled in order to setup a method. Costs are only accumulated when used by a Station. Please reach out to to activate billing. {% endhint %} ## To add a Microsoft Exchange data retrieval method to your organisation: {% stepper %} {% step %} ### Navigate to the Data Monitoring Tab Click on the 'Organisations' icon. ![](/files/IajZxbwLHCXovE9JkJ7Z) Select your organisation from the drop down menu and click on 'Data Monitoring' {% endstep %} {% step %} ### Click 'Add Method' Click 'Add Method' to add a data retrieval method.
A window appears in which you can add the necessary Microsoft Exchange credentials - to obtain the credentials see the following steps. {% hint style="danger" %} Please enter the relevant Microsoft Exchange credentials on BrightHub for your own organisation. These credentials are encrypted in the BrightHub database. Only the organisation owner can view or edit credentials. For data security purposes, please do not share credentials via alternative channels such as email - if you encounter difficulties, please contact . {% endhint %} {% endstep %} {% step %} ### Register an App in Azure Active Directory [Register an application with the Microsoft identity platform - Microsoft Graph](https://learn.microsoft.com/en-us/graph/auth-register-app-v2) in Azure Active Directory. BrightHub utilises Microsoft Graph API to interact with your mailbox, allowing you to set granular permissions to control its access. {% hint style="info" %} The **Redirect URI** field can be left empty: The Redirect URI is only needed for interactive user login and not applicable to the Microsoft Graph API authentication required for BrightHub integration. {% endhint %} {% endstep %} {% step %} ### Grant the App Mail.ReadWrite Permissions Use Microsoft Graph to [limit application permissions to specific Exchange Online mailboxes](https://learn.microsoft.com/en-us/exchange/permissions-exo/application-rbac). BrightHub requires the Mail.ReadWrite permission, which enables BrightHub to read and manage emails within your mailbox. It does not allow BrightHub to send emails. Ensure that the Application client has been granted the MS Graph Mail.ReadWrite permission and that the Admin consent as been granted. {% hint style="danger" %} Please confirm that the app has been set up to access the **correct mailbox only** - not across all mailboxes in your Exchange organisation. It is recommended that you use the test-connection button with a different organisation mailbox object id to ensure that the connection fails for all but the intended mailbox. {% endhint %} {% endstep %} {% step %} ### Enter Credentials on BrightHub User Interface Enter the Microsoft Exchange Online authorisation credentials to grant BrightHub permission to process data emails sent by data loggers to this email. {% endstep %} {% endstepper %}
Tenant ID This is the ID of the Azure AD tenant associated with your Microsoft 365 subscription
Client ID The client (application) ID of your registered Azure AD app.
Client Secret The Client Secret **Value** generated for your Azure AD app. {% hint style="info" %} Note that the Client Secret refers to the secret **Value**, not Secret ID. {% endhint %}
Object ID The object ID **of the mailbox** BrightHub should access (e.g. ). Go to Azure -> Users -> -> Object id {% hint style="info" %} Note this is not the object ID for the application client. {% endhint %}
Display Name The display name is used for BrightHub identification only. We strongly recommend using **the email address of the mailbox being accessed** to avoid confusion.
Mailbox Folder Specify the mailbox folder you wish BrightHub to read emails from. By default, this will be **Inbox**. If you would like to use an alternative mailbox folder, enter the name of the mailbox in this field. BrightHub will search the root level and if that name is found it will use this one over any duplicate folder names that may exist as subfolders. If the folder name does not exist at the root level, a folder with the given name will be created. For more detail on how the mailbox will be configured by BrightHub, see [BrightHub Mailbox Folder](/brighthub-user-docs/reference-user-manual/brighthub-organisations/organisation-data-monitoring/brighthub-mailbox-folder.md).
Methods such as Box, Google Cloud and SFTP can be set up at the station level. To set up an alternative data retrieval method, please reach out to . --- # 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: ``` GET https://brightwind.gitbook.io/brighthub-user-docs/reference-user-manual/brighthub-organisations/organisation-data-monitoring.md?ask= ``` 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.