Webhooks

Create webhook

Subscribe to regulation change events via webhook. Requires an HTTPS endpoint URL.

post/v1/webhooks

Request

Base URL: https://api.hempdata.io
URL: https://api.hempdata.io/v1/webhooks
Auth: HTTP bearer

Request body

endpoint_urlstring uri required

HTTPS URL to receive webhook payloads

Example request

{
  "endpoint_url": "https://example.com/webhooks/hempdata",
  "filters": {
    "jurisdictions": [
      "CO",
      "CA",
      "NY"
    ],
    "substances": [
      "delta-9-thc",
      "delta-8-thc"
    ],
    "events": [
      "regulation.updated",
      "regulation.status_changed"
    ]
  }
}

Response

Webhook created

successboolean required

metaobject

Example response

{
  "success": true,
  "data": {
    "signing_secret": "whsec_...",
    "status": "active"
  },
  "errors": [
    {
      "code": "INVALID_STATE_CODE",
      "message": "Invalid state code: XX"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.