Resolido Docs
Webhooks

Create webhook

POST
/webhooks

Create a webhook endpoint. Returns the signing secret once – store it to verify the webhook-signature header. Owner/admin, max 10 per organization.

Authorization

bearer webhooks:manage
headerAuthorizationBearer <token>

API key (rsl_live_…) from Settings → Developers.

Scope: webhooks:manage

Request Body

application/json
  1. body
url*string

Public https URL that receives POST requests with the event JSON.

Formaturi
Lengthlength <= 2000
events?array<>

Event types to send. Empty or omitted = all events.

Itemsitems <= 6
Default[]
description?string
Lengthlength <= 200

Response Body

Success

application/json
  1. response
id*string
url*string
description*string
events*array<string>

Subscribed event types; empty = all events.

enabled*boolean
disabledReason*string

too_many_failures when Resolido turned the endpoint off after days of failed deliveries.

consecutiveFailures*number
lastDeliveryAt*number

Unix time in milliseconds (UTC).

lastSuccessAt*number

Unix time in milliseconds (UTC).

createdAt*number

Unix time in milliseconds (UTC).

secret*string

Signing secret (whsec_…). Shown only now.

curl -X POST "https://example.com/webhooks" \  -H "Content-Type: application/json" \  -d '{    "url": "http://example.com"  }'
{  "id": "string",  "url": "string",  "description": "string",  "events": [    "string"  ],  "enabled": true,  "disabledReason": "string",  "consecutiveFailures": 0,  "lastDeliveryAt": 0,  "lastSuccessAt": 0,  "createdAt": 0,  "secret": "string"}