Bulk Resend Notifications

Use this endpoint to bulk-resend the webhook notifications that match a set of filters.

Available Environments

Production

https://api.gateway.com.br/dispatcher

Endpoint

• Method: POST
• Endpoint: /request/resend
• Authentication: Bearer token

Body Rules

ℹ️ Conditional rules

You must send one of the options below:

• startDate + endDate (when referenceId is not sent)
• referenceId (when startDate and endDate are not sent)

To cover every field of the DTO, use the complete examples of both scenarios below.

ℹ️ Dates cannot be in the future

The startDate and endDate fields must be valid ISO 8601 dates and not in the future.

Example:

• 2026-03-24T00:00:00Z

Name	Type	Required	Description	Validations
startDate	string (ISO 8601)	Conditional	Start date of the filter	Required when referenceId is not sent. Cannot be in the future
endDate	string (ISO 8601)	Conditional	End date of the filter	Required when referenceId is not sent. Cannot be in the future
referenceId	string	Conditional	Reference ID of a specific notification	Required when startDate and endDate are not sent
status	string[] (enum) - RECEIVED, SENT, FAILED, ERROR	No	List of statuses for the filter	Must be a non-empty array
tags	string[]	No	List of tags for the filter	Non-empty array, at most 10 items
overrideURL	string (URL)	No	URL that replaces the current destination URL of the notification on the resend (where the notification will be sent)	Must be a valid URL

Request Example (startDate + endDate scenario)

cURL

curl --request POST \
--url https://api.gateway.com.br/dispatcher/request/resend \
--header 'Authorization: Bearer your-jwt-token' \
--header 'Content-Type: application/json' \
--data '{
  "startDate": "2026-03-23T00:00:00Z",
  "endDate": "2026-03-24T23:59:59Z",
  "status": ["RECEIVED", "SENT", "FAILED", "ERROR"],
  "tags": ["webhook", "notification"],
  "overrideURL": "https://api.example.com/webhooks/custom-callback"
}'

JavaScript

const payload = {
  startDate: '2026-03-23T00:00:00Z',
  endDate: '2026-03-24T23:59:59Z',
  status: ['RECEIVED', 'SENT', 'FAILED', 'ERROR'],
  tags: ['webhook', 'notification'],
  overrideURL: 'https://api.example.com/webhooks/custom-callback'
};

const response = await fetch('https://api.gateway.com.br/dispatcher/request/resend', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer your-jwt-token',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify(payload)
});

Request Example (referenceId scenario)

cURL

curl --request POST \
--url https://api.gateway.com.br/dispatcher/request/resend \
--header 'Authorization: Bearer your-jwt-token' \
--header 'Content-Type: application/json' \
--data '{
  "referenceId": "123e4567-e89b-12d3-a456-426614174001",
  "status": ["RECEIVED", "SENT", "FAILED", "ERROR"],
  "tags": ["webhook", "notification"],
  "overrideURL": "https://api.example.com/webhooks/custom-callback"
}'

JavaScript

const payload = {
  referenceId: '123e4567-e89b-12d3-a456-426614174001',
  status: ['RECEIVED', 'SENT', 'FAILED', 'ERROR'],
  tags: ['webhook', 'notification'],
  overrideURL: 'https://api.example.com/webhooks/custom-callback'
};

const response = await fetch('https://api.gateway.com.br/dispatcher/request/resend', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer your-jwt-token',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify(payload)
});

Success Response

Code	Description
201 Created	Request accepted for resend processing

ℹ️ Response body

This endpoint returns 201 and has no response payload.

Possible Errors

Code	Description	Solution
400	Invalid request	Check the body format and the conditional rules
401	Invalid credentials	Check your token
403	No permission/authorization	Check the resend_dispatcher scope
422	Unprocessable entity	Review the fields and validations
500	Internal error	Contact support