FileForms
Webhook endpoints

Create Webhook Endpoint

POST
/webhook-endpoints

Create a webhook endpoint. The signing secret is returned only in this response; store it securely to verify webhook signatures.

Authorization

ApiKeyAuth
x-api-key<token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

curl -X POST "https://example.com/webhook-endpoints" \  -H "Content-Type: application/json" \  -d '{    "url": "http://example.com",    "eventTypes": [      "document.uploaded"    ]  }'
{  "id": "string",  "url": "string",  "eventTypes": [    "document.uploaded"  ],  "createdAt": "2019-08-24T14:15:22Z",  "secret": "string"}

Resend Webhook Deliveries POST

Make one immediate delivery attempt for each of 1-100 events, returning a per-item outcome (unknown ids report as failed items rather than failing the batch). Resends deliver the SAME events — same `id` and payload, with fresh signature timestamps — so consumers must deduplicate on the event `id`. Works for any event, including already-delivered ones; automatic retries are not restarted or consumed. To retry every failed delivery of an endpoint instead, use Retry Failed Deliveries.

Delete Webhook Endpoint DELETE

Delete a webhook endpoint. Events are no longer delivered to it.