Create an endpoint

POST
/v1/webhook-endpoints

Deliveries are signed per the Standard Webhooks specification. The signing secret is returned once, in this response.

Authorization

apiKey
headerAuthorizationBearer <token>

An API key from the Developers page. rhq_test_ keys reach the sandbox, rhq_live_ keys the live side.

Request Body

application/json
  1. body
url*string

Must be https and resolve to a public address

Formaturi
Lengthlength <= 500
events?array<|>

The event types to deliver; * is every event

Items1 <= items
Default
[  "*"]

Response Body

Created

application/json
  1. response

Created

id*string
url*string
events*array<string>

The event types delivered here; * is every event

enabled*boolean
createdAt*string

ISO 8601 timestamp

Formatdate-time
secret*string

The signing secret. Store it now; it is not shown again

curl -X POST "https://example.com/v1/webhook-endpoints" \  -H "Content-Type: application/json" \  -d '{    "url": "https://example.com/hooks/resellerhq"  }'
{  "id": "whe_01K6XJ4Q8ZT3M9R5V2B7WDHNCA",  "url": "https://example.com/hooks/resellerhq",  "events": [    "number.message.received"  ],  "enabled": true,  "createdAt": "2026-10-07T11:04:31.000Z",  "secret": "whsec_MfKQ9r8GKYqrTwjUPD8ILPZIo2LaLaSw"}