Small and medium business | Business Central, N...

Webhook registration error on Business Central - Service has not provided a valid validation token.

(4) Share

Report

Posted on by Rebe.Gwaindepy

216

Hi All,

I am having a challenge registering a webhook for a test api created on pipedream. I am sending the below request to BC on postman:

{
  "notificationUrl": "https://eoztfhvd9hhltme.m.pipedream.net",
  "resource": "/api/v2.0/companies(xxxxxxxx-xxxx-ef11-9345-002248f9xxxx)/customers",
  "clientState": "optionalValueOf2048"
}

The api is responding with the below details:

{
"validationToken": "35cc6401-3a19-408c-9cc8-c0c3647c3a59"
}

However, BC fails with the error:

{
    "error": {
        "code": "BadRequest",
        "message": "Service has not provided a valid validation token.  CorrelationId:  b06da1b0-8d24-4697-bea4-8ccb8acbd100."
    }
}

Does anyone have an idea as to what BC could be expecting structure wise here? I cannot find the BC code that registers webhooks.

Categories:

Dynamics 365 Business Central

I have the same question (0)

All responses (7)

Answers (0)

Suggested answer

Holly Huffman 6,530 Super User 2025 Season 2 on at

Like (2)

Report
Hi there! Good morning, evening, or afternoon - depending on where you are :) Hope you are well today!

Apologies if you've tried these already, here are a few suggestions:

The error you're encountering indicates that Business Central is not receiving the expected validation token during the handshake process. When registering a webhook, Business Central sends a validation request to the notificationUrl you provided. The service at the notificationUrl must respond with the validationToken in the response body and return an HTTP status code of 200.

Here’s how you can resolve this issue:

Verify the Handshake Response: Ensure that the service at https://eoztfhvd9hhltme.m.pipedream.net is configured to:

Extract the validationToken from the incoming request.

Return the validationToken in the response body.

Respond with an HTTP status code of 200.
For example, the response from your service should look like this:
json
{
"validationToken": "35cc6401-3a19-408c-9cc8-c0c3647c3a59"
}

Check the API Endpoint Configuration: Ensure that the notificationUrl is publicly accessible and can handle incoming requests from Business Central. Any restrictions, such as firewalls or authentication requirements, might block the validation request.

Test the Endpoint: Use a tool like Postman to simulate the validation request from Business Central. Send a request to your notificationUrl with a validationToken parameter in the query string and verify that the service responds correctly.

Review Business Central Documentation: Refer to the official documentation on webhook registration for detailed guidance on setting up and troubleshooting webhooks in Business Central.

Debugging with Logs: If the issue persists, check the logs of your service at notificationUrl to see if the validation request from Business Central is being received and processed correctly.

Was this reply helpful? Yes No
Ramesh Kumar 7,527 Super User 2025 Season 2 on at

Like (1)

Report

Hi,

Looks like you getting validation error message for webhook. I hope below link can help you to review

https://demiliani.com/tag/webhooks/

https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/api-reference/v2.0/dynamics-subscriptions

Thanks

Ramesh

If this was helpful, please check the "Does this answer your question?" box and mark it as verified.

Was this reply helpful? Yes No
Suggested answer

YUN ZHU 95,329 Super User 2025 Season 2 on at

Like (1)

Report

It looks like an authentication issue. Hopefully the following information can give you some hints.

Using OAuth to connect Business Central APIs and Web Service in Postman

https://yzhums.com/20690/

Thanks

ZHU

Was this reply helpful? Yes No
Rebe.Gwaindepy 216 on at

Like (0)

Report

Hi all.
Thank you for your responses.

@YUN ZHU, I am sure Postman is communicating with BC well and i have used OAuth (guided by your blog post) successfully for some time. The challenge, from what I can see is when BC sends the handshake request to the notification URL. Somehow its complaining about an invalid token response.

@Ramesh Kumar, i used these 2 posts as a guide to setting this up:

How to test Business Central webhooks – Kauffmann @ Dynamics 365 Business Central
Webhooks with Dynamics 365 Business Central – Stefano Demiliani

Because I do not have an Azure App running I decided to use pipedream.

@Holly Huffman, I ran all the suggested tests and even on postman it seems to be working:

When i send the request through the BC API:

I am confused with regards to what BC is expecting as a response and i cant find any documentation from Microsoft on this.

I hope this information helps.

Thanks,

Rebe

Was this reply helpful? Yes No
Suggested answer

Khushbu Rajvi. 20,275 Super User 2025 Season 2 on at

Like (2)

Report

https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/api-reference/v2.0/dynamics-subscriptions

https://demiliani.com/2019/12/10/webhooks-with-dynamics-365-business-central/

Was this reply helpful? Yes No
Jainam M. Kothari 15,631 Super User 2025 Season 2 on at

Like (1)

Report

Hello,

Just Like below may Other Technical Experts can better answer on this question

Was this reply helpful? Yes No
Vahid Ghafarpour 12,090 Super User 2025 Season 2 on at

Like (1)

Report

If any of the responses helped resolve your issue, please take a moment to mark the best answer. This helps others in the community quickly find solutions to similar problems.

To do this, simply click the "Does this answer your question?" button on the most helpful response and like the helpful posts. If your issue is still unresolved, feel free to provide more details so the community can assist further!

Thanks for being an active part of the Dynamics 365 Community!

Was this reply helpful? Yes No