---
title: "Subscribe to webhook events"
method: POST
path: "/webhooks"
tags: ["Webhooks"]
---

# Subscribe to webhook events

`POST /webhooks`

Creates a webhook endpoint that receives HTTP POST notifications when specified events occur.

## Request body

- object
  - `name` string, required — Webhook name (e.g. 'Zapier: New Lead')
  - `url` string, uri, required — URL to receive webhook POST requests
  - `events` string[], required — Events to subscribe to

## Response `200`

OK

- object
  - `id` string, required — Webhook endpoint public ID
  - `name` string, required
  - `url` string, required
  - `events` string[], required
  - `status` string, required
  - `secret` string, required — Signing secret (one-time reveal)
  - `createdAt` string, date-time, required

---

[API](https://skmtc.net/heffl/apis/heffl-api-v2-beta.md) · [All operations](https://skmtc.net/heffl/apis/heffl-api-v2-beta/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/heffl/heffl-api-v2-beta/revisions/27006cfef4d8/schema)