APIs & Integrations

drbitbrain
Membre

Webhooks response

Résolue

Hi,

 

I am building the endpoint where the webhook subscriptions will be talking to but from the documentation it is not clear for me what response should I give.

 

In the docs https://developers.hubspot.com/docs/methods/webhooks/webhooks-overview it says:

 

We will retry in the following cases:

  • Connection Failed - If we cannot open an http connection to the provided webhook URL
  • Timeout - If your service takes longer than 2 second to send back a response to a batch of notifications
  • Error codes - If your service responds with an HTTP status code that is not one of: 400, 401, 403, 404, 405

 

I understand that normally we would need to respond with a 204 (Success, No content) if everything went ok and any other code if something went wrong. I also understand that what the docs are saying is that if you return anything else that is not a 4XX or a 2XX code, it will retry again to send the notifications.

 

Am I right?

0 Votes
1 Solution acceptée
Derek_Gervais
Solution
Ancien salarié HubSpot
Ancien salarié HubSpot

Webhooks response

Résolue

Hey @drbitbrain ,

 

Yes, you're exactly correct. You should respond with a 2XX status code for any successful requests. Other useful responses might be:

  • 429 - If you respond with a 429, HubSpot will retry the request, respecting the `Retry-After` header.
  • 5XX - If you respond with any 5XX error, we'll retry according to our default retry logic outlined in the webhooks doc.
  • 400/401/403/404/405 - If you respond with any of these, HubSpot will not retry the webhook, so you should only respond with one of these codes if you do not want the notification.

Voir la solution dans l'envoi d'origine

0 Votes
3 Réponses
Derek_Gervais
Solution
Ancien salarié HubSpot
Ancien salarié HubSpot

Webhooks response

Résolue

Hey @drbitbrain ,

 

Yes, you're exactly correct. You should respond with a 2XX status code for any successful requests. Other useful responses might be:

  • 429 - If you respond with a 429, HubSpot will retry the request, respecting the `Retry-After` header.
  • 5XX - If you respond with any 5XX error, we'll retry according to our default retry logic outlined in the webhooks doc.
  • 400/401/403/404/405 - If you respond with any of these, HubSpot will not retry the webhook, so you should only respond with one of these codes if you do not want the notification.
0 Votes
dan9
Membre

Webhooks response

Résolue

This appears not to be the case anymore. I get retries on 400

0 Votes
jcaron
Membre

Webhooks response

Résolue

Sadly this response is more accurate and more clear than the official documentation.

0 Votes