Getting Started with Garage Hive APIs

Getting Started with Garage Hive APIs

**Article Status Update****:** This article has been recently updated and is currently under review. Please check back later.
Garage Hive has a wide range of API capabilities. There are standard Microsoft Business Central APIs available to all users, as well as Garage Hive-built endpoints — some available to everyone, and some included in the  Garage Link Advanced⁠  module.
For a comprehensive guide to how Business Central integrations work — including web services, authentication, and integration scenarios — see Microsoft's official documentation:  Integration overview for Business Central .


API Groups

The table below shows the different API groups available in Garage Hive, who built them, which Business Central permission set each one requires, and whether they are included in the Garage Link Advanced module. The Service API and Online Booking API are currently in beta.
API Type
Category
Description
Permission Set Required
Advanced Module Required
Built By
Microsoft built REST APIs in Business Central
Microsoft Business Central Standard
Standard BC endpoints for items, customers, invoices, journals, and more. Maintained by Microsoft.
A standard Business Central permission set, such as D365 AUTOMATION. No Garage Hive permission set is needed.
No
Microsoft
Garage Hive built OData v4 Web Services in Business Central
Garage Hive General (read-only)
Read-only endpoints for Garage Hive data — used by Power BI and other reporting tools.
GHV GARAGELINK API
No
Garage Hive
Garage Hive Phone Integration REST API Group in Business Central
Garage Hive Phone Integration
Phonebook endpoint for caller identification and customer lookup.
GHV PHONEBOOK API for phonebook lookups. GHV PHONE LOG API for communication log data.
No
Garage Hive
Garage Hive General and Garage Hive Service REST API groups in Business Central
Garage Hive Service
Read-write endpoints for jobsheets and jobsheet lines. Also supports Post, Email, and Post and Email actions on jobsheets, allowing API consumers to complete the full jobsheet workflow programmatically.
GHV GARAGELINK API
Yes
Garage Hive
Garage Hive built REST API outside of Business Central
Online Booking API
Fully custom-built API for creating workshop bookings programmatically through a session-based workflow.
Not applicable. This API runs outside Business Central and does not use Business Central permission sets.
Yes
Garage Hive
Assign only the permission sets an integration actually needs. An application that reads phonebook data should not also be able to reach jobsheets or financial records.  Garage Hive API Permission Sets⁠  explains what each set covers, and which combinations are known to work together.

Authentication

All Garage Hive and Business Central APIs require authentication through Microsoft Entra ID (formerly Azure Active Directory). Before making any API calls, you must obtain an access token by sending a POST request to the Microsoft identity platform token endpoint:
POST https://login.microsoftonline.com/{{tenantId}}/oauth2/v2.0/token
Replace {{tenantId}} with the client's Microsoft Entra ID tenant ID. The returned access token must then be included as a Bearer token in the Authorization header of every API request. Note that the HTTP header name is spelled Authorization, with a z, as defined by the HTTP standard.
Note: Authentication is handled entirely by Microsoft. For full details on the required parameters, grant types, and scopes, see  Authenticating Business Central Web Services using OAuth  on Microsoft Learn.

Need Help?

If you have questions about connecting to the Garage Hive APIs or need assistance with your integration, contact  Garage Hive support⁠ .



See Also



Globe with Meridians English (UK, IE, IM and IZ). To find documentation in other regions where Garage Hive operates, click  here.