> This page is for Product Documentation. > For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.navipartner.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.navipartner.com/_mcp/server. # Set up HeyLoyalty webhook > This article walks you through the process of setting up a webhook at HeyLoyalty that is needed for sending changes done to members directly in HeyLoyalty to Business Central. To ensure that the changes made to members directly in HeyLoyalty are synchronized back to Business Central (BC), you need to set up a webhook in your HeyLoyalty environment. ## Prerequisites Make sure you've [*set up member synchronization*](/product/ecommerce-heyloyalty-aad-app) in Business Central before moving on to procedural steps. ## Procedure in Business Central 1. Click the **Search:** button, search for the **Web Services** page, and open it. 2. Find the webservice address that was created in Business Central for HeyLoyalty.\ It should have **Service Name** = *heyloyalty_services*. 3.Copy the web service link from the field **OData V4 URL**. 3. Adjust the link address, so HeyLoyalty can understand it correctly:\ Generally a Business Central webservice URL for HeyLoyalty has the following structure: ```URL https://api.businesscentral.dynamics.com/v2.0///ODataV4/Company('')/heyloyalty_services ``` As you can see, there are character pairs `('` and `')` around your BC company name. HeyLoyalty doesn't support this. So you'll need to replace the `('` with its URL encoded representation `%28%27`, and the `')` with `%27%29`. For example: * Original URL: ``` https://api.businesscentral.dynamics.com/v2.0/1f807cd6-d8bf-4bb0-b2e4-922d41e37d37/Production/ODataV4/Company('CRONUS%20Danmark%20A%2FS')/heyloyalty_services ``` * Adjusted URL: ``` https://api.businesscentral.dynamics.com/v2.0/1f807cd6-d8bf-4bb0-b2e4-922d41e37d37/Production/ODataV4/Company%28%27CRONUS%20Danmark%20A%2FS%27%29/heyloyalty_services ``` ## Procedure in your HeyLoyalty environment 1. Select **Lists** from the top menu ribbon, then select **Edit List** on the list you want to set the webhook for. 2. Select the **Webhooks** subsection. !["Webhooks" subsection of a HeyLoyalty list](/_fern-img/8cfd587d8194276cddea8657183d2e7abcc9ea4e109dfaf7d2500de66f514db1.webp) 3. Click **Create a webhook**. Fill in the following fields for the new webhook: | Field name | Recommended value | | --------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **URL** | The adjusted web service URL from Business Central you have prepared earlier. | | **Contact email** | An email address to which webhook errors should be sent. | | **Send as raw json object** | `Yes` | | **Simplified format** | `Yes` | | **Authentication type** | `OAuth 2.0` | | **Username** | The **Application (Client) ID** from the Azure AD application details page that was shown to you at the end of the ["Create Microsoft Entra ID application for HeyLoyalty"](/product/ecommerce-heyloyalty-aad-app) process | | **Password** | The **Client Secret** value from the **Azure AD application details** page | | **base URL** | `https://login.microsoftonline.com//oauth2/v2.0` | | **scopes (optional)** | `https://api.businesscentral.dynamics.com/.default` | | **New subscriber (email, phone)** | `Yes` | | **New subscriber (heypush)** | `Yes` | | **Update subscriber** | `Yes` | | **Unsubscribe subscriber** | `Yes` | | **Spam complaint** | `Yes` | | **Hard bounces** | `Yes` |