We recommend that you subscribe to each event individually at a unique url that the webhook data is posted to. Upon reciept of your request you will get a response describing the details of your subscription. Please store this information in your database.

Subscribe via Dashboard

You can subscribe to each webhook via the dashboard under Settings->Webhooks. You can test the status of the webhook subscription there as well.

Subscribe via API

Use the subscription endpoint to create subscriptions. You can then test and manage those subscriptions in the dashboard .

The Subscription Object

Creating a subscription returns the subscription object below. You can retrieve all of your active subscriptions at any time with the list subscriptions endpoint.

{
  "event": "bettor.created",
  "url": "https://your-domain.com/webhooks/bettor-created",
  "content_type": "application/json",
  "user": 2,
  "id": "cce0fb16-a797-4dcc-adcf-db671c7ca624",
  "created_at": "2025-12-06T01:42:20.644478Z",
  "updated_at": "2026-08-14T11:38:48.930239Z",
  "subscription": "https://api.sharpsports.io/v1/hooks/cce0fb16-a797-4dcc-adcf-db671c7ca624",
  "hmac_secret": "<your 64 character hmac secret>",
  "hmac_digest": "sha256",
  "status": 200
}

Field	Description
`event`	The event this subscription is for, e.g. `bettor.created`. See webhook events.
`url`	The url the webhook is posted to.
`content_type`	The content type of the webhook post body.
`user`	The internal SharpSports id of the user that owns the subscription.
`id`	The uuid of the subscription. Sent on every webhook post in the `Hook-Subscription` header.
`created_at`	When the subscription was created.
`updated_at`	When the subscription was last updated.
`subscription`	The url of this subscription. Supports `GET` to retrieve it, `PATCH` to update it, and `DELETE` to remove it.
`hmac_secret`	The shared secret used to sign every webhook post for this subscription. See HMAC Verification.
`hmac_digest`	The digest algorithm used to sign webhook posts. Always `sha256`.
`status`	The http status code your endpoint returned the last time a webhook was posted to this subscription. `null` if it has never been posted to.