# Halliday Webhooks API

**Canonical:** https://apis.io/apis/halliday/halliday-webhooks-api/  
**Provider:** Halliday — https://apis.io/providers/halliday/  
**Base URL:** https://v2.prod.halliday.xyz  
**Documentation:** https://docs.halliday.xyz

Halliday Webhooks API is one of 4 APIs that [Halliday](https://apis.io/providers/halliday/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Webhook. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and a getting-started guide.

Register HTTPS endpoints to receive signed notifications when a workflow reaches a terminal state, instead of polling for status. You subscribe to one or more event types per webhook. | Event type | Fires when a workflow's status becomes | | --- | --- | | `WORKFLOW_COMPLETED` | `COMPLETE` | | `WORKFLOW_FAILED` | `FAILED` | All management endpoints live under `/orgs/webhooks` and authenticate with a secret API key (passed as a bearer token) that has webhook access. Publishable keys cannot manage webhooks. **Integration checklist** - Receiver is a public HTTPS endpoint (no private IPs). - Save the `signing_secret` when you create the webhook — it is shown only once. - Verify `X-Halliday-Signature` against the raw body, accepting any of its comma-separated signatures. - Respond `2xx` quickly and do the real work afterward. - Skip deliveries whose `id` you have already handled.

## Machine-readable artifacts (4)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/halliday/refs/heads/main/openapi/halliday-webhooks-api-openapi.yml
- **Documentation** — https://docs.halliday.xyz
- **APIReference** — https://docs.halliday.xyz/pages/halliday-api-docs.md
- **GettingStarted** — https://docs.halliday.xyz/pages/api-quickstart.md

## Other Halliday APIs (3)

- [Halliday Assets API](https://apis.io/apis/halliday/halliday-assets-api/)
- [Halliday Chains API](https://apis.io/apis/halliday/halliday-chains-api/)
- [Halliday Payments API](https://apis.io/apis/halliday/halliday-payments-api/)

## Tags

Webhook

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/halliday/halliday-webhooks-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/halliday/.