Developers

Webhooks

Last updated 26 July 2026

Outbound webhooks push JSON to your HTTPS URL when confirmed events happen. Configure in Workspace → API (Pro) or via Agent API scope webhooks:manage.

Slack

Customers connect their own Slack from Workspace → Integrations (OAuth). Hansala hosts one Slack app; each company authorizes their workspace and picks a channel. Confirmations and inquiries post there automatically. Partnership requests can include Accept / Decline buttons (bot chat:write).

Advanced: paste a Slack Incoming Webhook URL as a generic webhook endpoint under Workspace → API — Slack hosts are auto-formatted.

Events

inquiry.created — new profile inquiry
partnership.requested — pending partner request (recipient)
partnership.accepted — partnership confirmed (both companies notified)
reference.confirmed — client confirmed a service reference
booking.connected — Calendly / Cal.com link saved

Request

POST with Content-Type: application/json. Respond with 2xx within ~8s. We retry up to 3 times.

Hansala-Signature — t=…,v1=… HMAC-SHA256 of ${t}.${rawBody} with your endpoint secret
Hansala-Event — event type
Hansala-Delivery — delivery id
Hansala-Idempotency-Key — stable event id (dedupe)

Body

{
  "id": "evt_…",
  "type": "inquiry.created",
  "created_at": "2026-07-26T12:00:00.000Z",
  "data": { … }
}

Agent API

GET|POST /api/v1/agent/webhooks
PATCH|DELETE /api/v1/agent/webhooks/{id}
POST /api/v1/agent/webhooks/{id}/test

OpenAPI: Agent spec · info@hansala.com