# Webhooks response

**URL:** <https://community.hubspot.com/t/webhooks-response/15006>\
**Category:** APIs & Integrations\
**Tags:** webhooks\
**Created:** [June 27, 2019, 9:00am UTC](https://community.hubspot.com/t/webhooks-response/15006 "2019-06-27T09:00:04Z")\
**Posts on this page:** 4\
**Page:** 1

<div class="post-metadata">

**Author:** ![drbitbrain](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/drbitbrain/32/86357_2.png) [@drbitbrain](https://community.hubspot.com/u/drbitbrain)\
**Post date:** [June 27, 2019, 9:00am UTC](https://community.hubspot.com/t/webhooks-response/15006/1 "2019-06-27T09:00:04Z")

</div>

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 [Accounts Dashboard | HubSpot](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?

---

<div class="post-metadata">

**Author:** ![Derek\_Gervais](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/derek_gervais/32/17429_2.png) [@Derek\_Gervais](https://community.hubspot.com/u/Derek_Gervais)\
**Post date:** [June 27, 2019, 3:42pm UTC](https://community.hubspot.com/t/webhooks-response/15006/2 "2019-06-27T15:42:03Z")

</div>

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](https://developers.hubspot.com/docs/methods/webhooks/webhooks-overview).
- 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.

---

<div class="post-metadata">

**Author:** ![jcaron](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/jcaron/32/81360_2.png) [@jcaron](https://community.hubspot.com/u/jcaron)\
**Post date:** [May 29, 2020, 4:47pm UTC](https://community.hubspot.com/t/webhooks-response/15006/3 "2020-05-29T16:47:46Z")

</div>

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

---

<div class="post-metadata">

**Author:** ![dan9](https://avatars.discourse-cdn.com/v4/letter/d/e8c25b/32.png) [@dan9](https://community.hubspot.com/u/dan9)\
**Post date:** [March 24, 2023, 12:30pm UTC](https://community.hubspot.com/t/webhooks-response/15006/4 "2023-03-24T12:30:57Z")

</div>

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