Sometimes, a webhook configuration will fire an event that fails. This could be due to internal errors, network errors, or integration errors. When a single request generated by a webhook subscription (called an event) fails, LinkMoney caches the webhook payload for 10 days as an event object. Most of the time, you will see event objects as retrievals, which are failed event payloads associated with your webhook configuration.
By making a GET request to the , you can retrieve dropped events still cached by LinkMoney. We strongly suggest reading before exploring event retrieval.
Note that FindMoney programmatically
Reattempt an Event.
POST /configuration/webhooks/retrievals/:eventId
Cause a single webhook event to attempt a manual retry.
Parameters
No POST body is required for this request.
| Field | Type | Description |
|---|---|---|
eventId | string | The ID of the event you want to reattempt. |
Example Request
curl -X POST /configuration/webhooks/retrievals/{YOUR_EVENT_ID} \
-H 'Authorization: Bearer {YOUR_BEARER_TOKEN}'Response
The response will depend highly on your webhook endpoint's response to help troubleshoot any issues that may be causing the outage.
{
"responseCode": "200",
"responseMessage": "OK",
"callbackUrl:": "{MY_CALLBACK_URL}",
"eventName": "DATA_UPDATES",
"timeout": false,
"success": true
}Note that if the response's success field is set to true, it indicates that your callbackURL responded to the webhook event with a 2XX response code. LinkMoney will delete this cached event if the request succeeds. If the request fails, LinkMoney will still persist the dropped event.
Reattempt All Events
POST configuration/webhooks/retrievals
Cause all dropped webhook events to attempt retries.
Parameters
No parameters are required for this call.
Example Request
curl -X POST /configuration/webhooks/retrievals \
-H 'Authorization: Bearer {YOUR_BEARER_TOKEN}'Response
Responses follow the same schema as described by the retry one event endpoint.
{
"responses": [
Response,
Response
]
}LinkMoney will delete any cached event that receives a 2XX response code from your callbackURL. Any failing responses will still persist.