POST /v1/webhooks — Create Webhook

Requires X-API-Key

Request

curl -X POST 'https://api.puntersedge.online/v1/webhooks' \
  -H 'X-API-Key: YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"url": "https://example.com/hooks/puntersedge", "events": ["arb.opportunity"], "min_edge_pct": 1.5, "sports": ["nrl", "afl"]}'

Parameters

Name	In	Type	Required	Description
`url`	body	string	yes	HTTPS endpoint that receives the POST. Plain http:// is rejected with 422.
`events`	body	array	no	Events to subscribe to. `arb.opportunity` is the only event with a live producer. `odds.change` is delivered solely by POST /v1/webhooks/{id}/test; `race.result` and `market.suspend` are accepted but never fire.
`min_edge_pct`	body	number	no	Only deliver arb.opportunity when the theoretical edge is at least this percentage. Omit for every opportunity.
`sports`	body	array	no	Only deliver arb.opportunity for these sports. Sport keys as returned by GET /v1/sports, plus racing_thoroughbred / racing_harness / racing_greyhound. Omit for all sports.

Responses

Status codes: 200, 401, 402, 403, 422, 429, 500. Response bodies are JSON; the full schema is in /openapi.json.

Related endpoints

GET /v1/webhooks — List Webhooks
DELETE /v1/webhooks/{webhook_id} — Delete Webhook
GET /v1/webhooks/{webhook_id}/deliveries — List Webhook Deliveries
POST /v1/webhooks/{webhook_id}/test — Test Webhook

Try it against live data

The free tier needs no credit card, and the sandbox endpoints need no key at all.

Get a free API key Quickstart