Create webhook | Reloop Docs

POST

https://reloop.sh/api/webhook/v1/

Body Parameters

descriptionstringRequired

Webhook description

Minimum length: 1
Maximum length: 255

urlstringRequired

Webhook URL

eventsstring[]Required

Array of event IDs to subscribe to

Example: ["value1", "value2"]

const response = await fetch("https://reloop.sh/webhook/v1/", {
  method: "POST",
  headers: {
    "Authorization": "Bearer rl_123456789",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    name: "Payments Webhook",
    url: "https://example.com/webhooks/reloop"
  })
});

const webhook = await response.json();

{
  "id": "wh_123456789",
  "name": "Payments Webhook",
  "url": "https://example.com/webhooks/reloop",
  "secret": "***masked***",
  "status": "active",
  "customHeaders": {
    "x-source": "reloop"
  },
  "rateLimitEnabled": true,
  "maxRequestsPerMinute": 60,
  "maxRetries": 3,
  "retryBackoffMultiplier": 2,
  "filteringOptions": null,
  "lastTriggeredAt": "2026-03-29T10:00:00Z",
  "successCount": 10,
  "failureCount": 1,
  "consecutiveFailures": 0,
  "createdAt": "2026-03-29T10:00:00Z",
  "updatedAt": "2026-03-29T10:00:00Z"
}