Developers

Subscriptions

Subscribe backend systems to HiveBase events and verify deliveries with HMAC signatures.

Create a subscription

Subscription management uses the Platform API v2 and scoped API keys.

curl https://app.hivebase.ai/api/v2/subscriptions \
  -H "Authorization: Bearer $HIVEBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "callback_url": "https://example.com/hivebase/events",
    "events": ["task.created", "task.updated"]
  }'

Verify signatures

Use the full whsec_* secret as the HMAC-SHA256 key material when validating X-HiveBase-Signature.

const expected = hmacSha256(subscriptionSecret, rawRequestBody);
if (signature !== expected) {
  throw new Error("Invalid HiveBase subscription signature");
}