Create a webhook endpoint

Header Idempotency-Key (optional, up to 255 characters): retry with the same key and body within 24 hours and you get the first response back (Idempotent-Replayed: true) – the request is not run twice. Another body: 422 idempotency_key_reused; still running: 409 idempotency_key_in_progress. More.

Request body

Content types: application/json, application/x-www-form-urlencoded.

Example request

curl -X POST https://www.helprange.com/api/v2/webhook-endpoints \
  -H "X-API-Key: $HELPRANGE_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-binary '{"url": "https://hooks.example.com/helprange"}'

const res = await fetch('https://www.helprange.com/api/v2/webhook-endpoints', {
  method: 'POST',
  headers: {'X-API-Key': process.env.HELPRANGE_API_KEY, 'Content-Type': 'application/json'},
  body: JSON.stringify({
    "url": "https://hooks.example.com/helprange"
  }),
});
const data = await res.json();
if (!res.ok) throw new Error(`${res.status}: ${data.error || data.message || data.reason}`);
console.log(data);

import os

import requests

r = requests.post(
    'https://www.helprange.com/api/v2/webhook-endpoints',
    headers={'X-API-Key': os.environ['HELPRANGE_API_KEY']},
    json={
        "url": "https://hooks.example.com/helprange",
    },
    timeout=60,
)
r.raise_for_status()
print(r.json())

The samples read the key from the HELPRANGE_API_KEY environment variable.

Responses

{
  "id": 3,
  "url": "https://hooks.example.com/helprange",
  "enabled": true,
  "disabled_reason": null,
  "disabled_at": null,
  "consecutive_failures": 0,
  "last_success_at": null,
  "secret_rotated_at": null,
  "previous_secret_expires_at": null,
  "created_at": "2026-11-15T09:00:00+00:00",
  "events": [
    "document.acknowledged",
    "document.opened",
    "file_request.uploaded",
    "nda.accepted",
    "offer.accepted",
    "offer.contact_requested",
    "offer.declined",
    "room.access_requested"
  ],
  "secret": "whsec_q8Wm3…"
}

Try it