Error handling and recovery

You may need to act on problematic webhooks in two main cases: resending those that errored or replaying those that were missed.

Resending errored webhooks

Webhooks enter an error state once the Tuum system reaches the maximum retry limit for delivery. This occurs when there is a network or destination-system malfunction.

By following the steps below, you can retry sending any webhooks that still need to be sent and ignore those that do not.

1

Find errored webhooks

To retrieve the full list of webhooks in an ERROR state, use the Search notifications endpointarrow-up-right with the query parameters statusCodes=ERROR and channelCode=WEBHOOK.

2

Retry sending

Parse the response from step 1 and fetch the notificationId value for the webhooks you want to retry.

Use the Retry sending errored notificationarrow-up-right endpoint and specify a notificationId in the path to retry the selected errored notification.

circle-info

You can skip this step if you do not need any failed webhooks to be resent.

3

Ignore those that do not require resending

Parse the response from step 1 and retrieve the notificationId values for each webhook you plan to ignore.

Use the Ignore notifications in the errorarrow-up-right endpoint and list an array of notificationId values in the payload to clear the error status from selected errored notifications you do not intend to resend.

circle-info

You can skip this step if you do not plan to ignore any errored webhook.

Replaying missed webhooks

If you discover you missed a webhook that the Tuum system successfully sent, you can resend it.

Follow these steps to replay the notification and resend the webhook.

1

Identify missed webhooks

Use the Search notifications endpointarrow-up-right with the right query parameters to retrieve a limited number of webhooks. This helps you identify the missed webhook faster.

2

Replay notification for webhook resending

Parse the response from step 1 and fetch the notificationId value for the webhooks you want to replay.

Use the Replay notification endpointarrow-up-right and specify a notificationId in the path to resend the selected webhook.

Last updated

Was this helpful?