POST

Retrigger specific webhook notifications by ID

Resends a specific set of webhook notifications that you identify by their notification IDs (max 25 per request). Use this endpoint when you already have the exact notification ID(s) you want to resend, for example IDs you read from the 'id' field of records returned by the notification-history endpoints. Important: 'webhookNotificationIds' must be notification IDs returned by this API's own notification-history responses. Do NOT use any ID found inside the delivered webhook payload body (such as a transaction or transfer ID) — those are unrelated identifiers and will fail validation. If you do not have specific notification IDs, or you want to resend everything matching a time window or other filters, use the bulk notifications endpoint (POST /webhooks/notifications) instead. Note: retriggered webhooks use the original signature. If the webhook secret was rotated since the original send, the signature will be incorrect.

Path Params

webhookId string required

The webhook ID

Body Params

object

webhookNotificationIds array of strings

The notification IDs to resend (max 25). Each value must be a notification ID taken from the 'id' field of a record returned by the notification-history endpoints. Do NOT use any ID found inside the delivered webhook payload body (such as a transaction or transfer ID) — those are unrelated identifiers and will be rejected.

Responses

200

Retrigger results

Response Body

object

totalRequested integer int32 required
totalSuccess integer int32 required
totalFailed integer int32 required
successfulNotifications array of objects required
successfulNotifications object
- webhookNotificationId string uuid required
- retriggeredNotificationRequestId string
- error string
failedNotifications array of objects required
failedNotifications object
- Same shape as RetriggerNotificationResult.

400

Invalid request

Response Body

object

Bad request error response

name string enum required

Error code

ValidationFailedIllegalArgumentBadRequestDataIntegrityErrorNotImplementedErrorRETRIGGER_RATE_LIMITEDUSER_CREATION_FAILEDUSER_FALLBACK_FAILED
error string required

Human-readable error message
status integer enum int32 required

HTTP status code

400

403

Access denied

Response Body

object

Forbidden error response

name string enum required

Error code

AccessDenied
error string required

Human-readable error message
status integer enum int32 required

HTTP status code

403

404

Webhook not found

Response Body

object

Not found error response

name string enum required

Error code

NotFound
error string required

Human-readable error message
status integer enum int32 required

HTTP status code

404

409

Concurrent retrigger in progress

Response Body

object

Conflict error response

name string enum required

Error code

Conflict
error string required

Human-readable error message
status integer enum int32 required

HTTP status code

409

500

Unexpected error occurred

Response Body

object

Internal server error response

name string enum required

Error code

UnexpectedErrorThirdPartyErrorDatabaseErrorUSER_FALLBACK_TIMEOUT
error string required

Human-readable error message
status integer enum int32 required

HTTP status code

500

curl --request POST \ --url 'https://app.bitgo-test.com/api/notifications/v1/webhooks/webhookId/notifications/retrigger' \ --header 'accept: application/json' \ --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \ --header 'content-type: application/json' \ --data '{,"webhookNotificationIds":["string"]}'

const url = 'https://app.bitgo-test.com/api/notifications/v1/webhooks/webhookId/notifications/retrigger'; const options = { method: 'POST', headers: {accept: 'application/json', 'Authorization': 'Bearer YOUR_ACCESS_TOKEN', 'content-type': 'application/json'}, body: JSON.stringify({,"webhookNotificationIds":["string"]}) }; fetch(url, options) .then(res => res.json()) .then(json => console.log(json)) .catch(err => console.error(err));

require 'uri' require 'net/http' url = URI("https://app.bitgo-test.com/api/notifications/v1/webhooks/webhookId/notifications/retrigger") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["accept"] = 'application/json' request["Authorization"] = 'Bearer YOUR_ACCESS_TOKEN' request["content-type"] = 'application/json' request.body = '{,"webhookNotificationIds":["string"]}' response = http.request(request) puts response.read_body

<?php require_once('vendor/autoload.php'); $client = new \GuzzleHttp\Client(); $response = $client->request('POST', 'https://app.bitgo-test.com/api/notifications/v1/webhooks/webhookId/notifications/retrigger', [ 'headers' => [ 'accept' => 'application/json', 'Authorization' => 'Bearer YOUR_ACCESS_TOKEN', 'content-type' => 'application/json', ], 'body' => '{,"webhookNotificationIds":["string"]}', ]); echo $response->getBody();

import requests url = "https://app.bitgo-test.com/api/notifications/v1/webhooks/webhookId/notifications/retrigger" payload = {,"webhookNotificationIds":["string"]} headers = { "accept": "application/json", "Authorization": "Bearer YOUR_ACCESS_TOKEN", "content-type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.text)

{ "totalRequested": 0, "totalSuccess": 0, "totalFailed": 0, "successfulNotifications": [ { "webhookNotificationId": "string", "retriggeredNotificationRequestId": "string", "error": "string" } ], "failedNotifications": [ { "webhookNotificationId": "string", "retriggeredNotificationRequestId": "string", "error": "string" } ] }