REST API - Do you have retrying policy for webhooks?

API Q&A
#1

I couldn’t find any information about that in your documentation, and I think that is very important thing to properly and safely implement integration.

  1. When you servers send request to webhook’s url, do you check recipient server response?
  2. What happens when target server is unable to receive webhook request? - Do you retry request? - How many times, how often, how many attempts, etc.

For example, I know one very well documented retrying policy - https://www.marqeta.com/api/docs/Vh2dCRwAAMsAF3sg/webhooks-overview#run_time_characteristics

It would be great is such information will be available in REST API documentation.

Thanks,
Daniel

#2

Not sure of the retry policy but I believe if it’s not a 5xx server response (which will invalidate the url and require re-verifying) then some 4xx responses would be retried. Still, hold judgement on that until someone else can confirm the retry part.

#3

+1 This would be great information to have in the docs.

#4

We retry three times on failed resthook posts before discarding the request, and consider anything above a 300 or below a 200 a failure. I’ll look at updating the docs to reflect that.

2 Likes
#5

Are these retries delayed somehow, or are performed immediately one after one?

#6

@STX @Jordan_Novak @John_Borelli

Thank you for asking about REST Hooks. The API Team drafted a policies document but forgot to link it from our API documentation or share it, here.

Please have a look at https://developer.infusionsoft.com/rest-hook-documentation/ and let me know if it adequately covers the information you’re looking for.

1 Like