# Heap Webhooks API

**Canonical:** https://apis.io/apis/heap/heap-webhooks-api/  
**Provider:** Heap — https://apis.io/providers/heap/  
**Documentation:** https://developers.heap.io/reference/server-side-apis-overview

Heap Webhooks API is one of 10 APIs that [Heap](https://apis.io/providers/heap/) 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, and an API reference.

Partner-registered webhook endpoints invoked by Heap. The only documented action type is `segment.users.sync`, which delivers delta adds/removes for a Heap behavioral segment. Signature verification: 1. Parse the `Heap-Hash` header (comma-separated key:value pairs). 2. Confirm the `ts` value is within the partner's tolerance window. 3. Concatenate `${ts}${requestbody}`. 4. Compute HMAC-SHA256 using the `webhook_secret_key` assigned at webhook creation. 5. Constant-time compare against the `hmac` value from the header. Return `200 OK` on success; `429` or other non-2xx responses trigger retries by Heap.

## Machine-readable artifacts (3)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/heap/refs/heads/main/openapi/heap-webhooks-api-openapi.yml
- **Documentation** — https://developers.heap.io/docs/creating-a-new-heap-integration-partners
- **Reference** — https://github.com/heap/heap-partner-api-reference

## Other Heap APIs (9)

- [Heap Server-Side API](https://apis.io/apis/heap/server-side-api/)
- [Heap Track API](https://apis.io/apis/heap/track-api/)
- [Heap Identify API](https://apis.io/apis/heap/identify-api/)
- [Heap Add User Properties API](https://apis.io/apis/heap/add-user-properties-api/)
- [Heap Add Account Properties API](https://apis.io/apis/heap/add-account-properties-api/)
- [Heap Add Account Properties API](https://apis.io/apis/heap/heap-add-account-properties-api/)
- [Heap Add User Properties API](https://apis.io/apis/heap/heap-add-user-properties-api/)
- [Heap Identify API](https://apis.io/apis/heap/heap-identify-api/)
- [Heap Track API](https://apis.io/apis/heap/heap-track-api/)

## Tags

Webhook

---

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