Webhooks

Retry a failed webhook delivery

Immediately retries a webhook delivery using the original payload. Creates a new delivery log entry with the result.

POST
/v1/webhooks/{webhook_id}/deliveries/{delivery_id}/retry

Authorization

AuthorizationBearer <token>

API Key authentication.

Format: Authorization: Bearer beel_sk_<key>

Obtaining Keys: API Keys are managed from the BeeL dashboard

Security: API Keys are secret credentials. Do not share them or store them in source code

In: header

Path Parameters

webhook_idstring
Formatuuid
delivery_idstring
Formatuuid

Response Body

application/json

application/json

application/json

curl -X POST "https://app.beel.es/api/v1/webhooks/497f6eca-6276-4993-bfeb-53cbbbba6f08/deliveries/497f6eca-6276-4993-bfeb-53cbbbba6f08/retry"
{
  "success": true,
  "data": {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "subscription_id": "aa11a4c2-a467-43db-b413-c4ab0f5cf627",
    "webhook_event_id": "de12c964-92b7-4192-bb5b-e637b567397c",
    "event_type": "verifactu.status.updated",
    "attempt_number": 0,
    "http_status": 200,
    "response_body": "string",
    "duration_ms": 0,
    "success": true,
    "error_message": "string",
    "payload": "string",
    "request_headers": {
      "BeeL-Signature": "t=1741362026,v1=3c4f7a2e1b9d8e7f6a5b4c3d2e1f0a9b8c7d6e5f4a3b2c1d0e9f8a7b6c5d4e3f",
      "BeeL-Event": "verifactu.status.updated",
      "BeeL-Event-Id": "8ee6b023-c4e5-482e-93ca-dc66da2f9cb5",
      "BeeL-Delivery-Id": "b3873959-67d8-4a11-87ba-b39cc2d395fe",
      "Idempotency-Key": "8ee6b023-c4e5-482e-93ca-dc66da2f9cb5"
    },
    "delivered_at": "2019-08-24T14:15:22Z"
  },
  "meta": {
    "timestamp": "2025-01-15T10:30:00Z",
    "request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
  }
}
{
  "success": false,
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Authentication required"
  },
  "meta": {
    "timestamp": "2025-01-15T10:30:00Z",
    "request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
  }
}
{
  "success": false,
  "error": {
    "code": "NOT_FOUND",
    "message": "Resource not found"
  },
  "meta": {
    "timestamp": "2025-01-15T10:30:00Z",
    "request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
  }
}

List webhook subscriptions GET

Returns all webhook subscriptions for the authenticated account.

Rotate webhook secret POST

Generates a new HMAC secret for a webhook subscription. The old secret is **immediately invalidated** — update your signature verification logic before rotating to avoid missing events during the transition. The new secret is only returned **once** in this response.