Retry Policy
If the webhook URL or health check URL are unresponsive, the notifications will be resent based
on the retry policy. The retry policy is set in the
retryPolicy
object
of the subscription. You can set the retry policy when you POST the subscription request
or modify it later using a PATCH request. For more information about the health check
URL, see the Health Check URL topic for the applicable Webhooks subscription workflow.The retry fields are described below.
- deactivateFlag
- If thedeactivateFlagfield is set tofalseand all retry attempts fail, the subscription status changes toSUSPENDEDand the status of the notifications changes toFAILED. Customer support is notified and contacts you.If thedeactivateFlagfield is set totrue, notifications are held in a message queue and the status of the notifications is changed toSUSPENDED. When the health check URL becomes responsive, the subscription status changes toACTIVE.
- firstRetry
- Number of minutes before the notification is resent. The default value is1.
- interval
- Number of minutes between each retry. The default value is1.
- numberOfRetries
- Number of times to retry. The default value is3.
- repeatSequenceCount
- Number of times to repeat the retry sequence.
- repeatSequenceWaitTime
- Number of minutes between each repeat sequence.
Example: Retry Policy in a Subscription Request
"retryPolicy": { "firstRetry": "1", "interval": "1", "numberOfRetries": "3", "deactivateFlag": "false", "repeatSequenceCount": "0", "repeatSequenceWaitTime": "0" }