ResellerHQ
Log inTry the sandbox free
GuidesAPI reference
Webhooks

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
healthState*string

'unhealthy' is every delivery failing for a day; 'paused' is seven, and stops new deliveries being attempted (they still queue, nothing is lost) until it is fixed

Value in"healthy""unhealthy""paused"
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",  "healthState": "healthy",  "secret": "whsec_MfKQ9r8GKYqrTwjUPD8ILPZIo2LaLaSw"}

Withdraw unspent funds from a sub-reseller POST

Moves money out of a sub-reseller's wallet and back into your own, the mirror of fund. Moves only what is available: a sub-reseller's held funds belong to orders in flight and are never disturbed, so an over-withdrawal is refused with nothing moved. Allowed even when the sub-reseller is suspended, since suspension only stops it spending - the money withdrawn is yours to recover. Send an Idempotency-Key header so a retry can never move the money twice.

List endpoints GET

Next Page