Webhook receiving

Endpoint URL

Every webhook endpoint is reachable at:

https://api.hooknexus.com/h/:endpointId

Property	Value
HTTP methods	Any (GET, POST, PUT, PATCH, DELETE, …)
Authentication	None for sending webhooks—senders use the public URL
Path parameter	endpointId — UUID of the endpoint

Note

If the endpoint is expired or unknown, the API returns 404. Browser navigation to the bare URL may return 404 by design to reduce noise from accidental visits.

Successful response

On success, HookNexus stores the request and returns JSON:

{
  "received": true,
  "id": "<request-log-id>",
  "timestamp": 1711180800123
}

Field	Type	Description
received	boolean	Always true on success
id	string	Unique ID of the stored webhook log (use with Request APIs)
timestamp	number	Unix time in milliseconds

Size and rate limits

Limits are enforced per account plan (cached on the endpoint owner):

Limit	Behavior
Max body size	If the body exceeds the plan’s max_request_size, the API returns 413 with error, maxSize, and actualSize.
Daily request volume	If the daily cap is reached, the API may return 429 with limit details.

Examples with curl

POST JSON

curl -X POST "https://api.hooknexus.com/h/YOUR_ENDPOINT_ID" \
  -H "Content-Type: application/json" \
  -d '{"event":"invoice.paid","id":"evt_123"}'

GET with query string

curl "https://api.hooknexus.com/h/YOUR_ENDPOINT_ID?foo=bar"

Custom headers

curl -X POST "https://api.hooknexus.com/h/YOUR_ENDPOINT_ID" \
  -H "X-Custom-Header: value" \
  -H "Content-Type: text/plain" \
  --data-binary "raw payload"

Incoming webhooks are broadcast to connected WebSocket clients in real time. See WebSocket.