Graph Connection

Learn how to set up the Microsoft Graph connection for Pryme Time to synchronize calendar appointments, emails, and Teams meetings.

  3 minute read  

Configuring the Microsoft Graph Connection

The Microsoft Graph connection is needed for synchronizing calendar appointments, emails and Teams meetings. This data is used to create time tracking entries either directly or when using the Copilot feature to complete timesheets.

Create an Entra ID app registration

Before configuring the connection to Microsoft Graph in Business Central, an Entra ID app registration must be created. The app registration is used to authenticate and authorize the connection between Business Central and Microsoft Graph, it establishes a trust relationship between your app and the Microsoft identity platform.

Only users with sufficient permissions in Entra ID can create an app registration. Regular users typically do not have the necessary permissions to create app registrations. If you are unsure about your permissions, contact your Entra ID administrator.

Follow these steps to create the app registration:

  1. Sign in to the Microsoft Entra admin center.
  2. If you have access to multiple tenants, switch to the tenant in which you want to register the application.
  3. Browse to Entra ID > App registrations and select New registration.
  4. Enter a meaningful Name for your application, for example BC Pryme Time, it can be changed at any time.
  5. Under Supported account types, specify who can use the application. We recommend you select Accounts in this organizational directory only.
  6. Select Register to complete the app registration.
  7. The application’s Overview page is displayed. Record the Application (client) ID, which uniquely identifies your application. You will need this ID later when configuring the connection in Business Central.
  8. In the left navigation pane, select Certificates & secrets.
  9. Under Client secrets, select New client secret.
  10. Enter a description for the client secret, such as BC Pryme Time Secret, and select an expiration period that suits your needs.
  11. Select Add to create the client secret.
  12. After the client secret is created, copy the Value of the client secret. This value is only displayed once, so make sure to save it securely. You will need this value later when configuring the connection in Business Central.
  13. In the left navigation pane, select API permissions.
  14. Select Add a permission.
  15. Select Microsoft Graph.
  16. Select Application permissions.
  17. In the search box, type Calendars.Read, select it from the list, and then select Add permissions.
  18. Repeat the previous step to add the following permissions:
    • Mail.Read
    • CallRecords.Read.All
    • User.ReadBasic.All
  19. After adding the permissions, select Grant admin consent for [Your Organization] to grant the permissions to the app.
  20. Confirm the action when prompted.

To set up the Microsoft Graph connection in Business Central

  1. Choose the 🔎 icon, enter PRyme Time Setup, and then select the related link.
  2. In the Microsoft Graph Connection fast tab, fill in the fields as necessary:
    • Client ID: Enter the Application (client) ID you recorded earlier.
    • Client Secret: Enter the client secret value you copied earlier.