---
title: "Changes to Create a webhook"
method: POST
path: "/v1/webhooks"
---

# Changes to Create a webhook

`POST /v1/webhooks`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 2 revisions.

- **2026-11-03** `c6818f3ba60d`: 14 info

## Changes

- **2026-11-03** `c6818f3ba60d`: 14 info
  - added the new optional `header` request parameter `Idempotency-Key`
  - added the new `person_enrichment.finished` enum value to the request property `subscribedEvents/items/eventType`
  - added the new `task.completed` enum value to the request property `subscribedEvents/items/eventType`
  - added the new `task.created` enum value to the request property `subscribedEvents/items/eventType`
  - added the new `task.deleted` enum value to the request property `subscribedEvents/items/eventType`
  - added the new `task.updated` enum value to the request property `subscribedEvents/items/eventType`
  - added the non-success response with the status `409`
  - the response property `error/details` became required for the status `429`
  - added the required property `error/details/limit` to the response with the `429` status
  - added the required property `error/details/policies` to the response with the `429` status
  - added the required property `error/details/policy` to the response with the `429` status
  - added the required property `error/details/remaining` to the response with the `429` status
  - added the required property `error/details/retryAfter` to the response with the `429` status
  - added the required property `error/details/windowSeconds` to the response with the `429` status

---

[Operation](https://skmtc.dev/folk/apis/folk-external-api/docs/v1/webhooks/post.md) - [API](https://skmtc.dev/folk/apis/folk-external-api.md) - [Page](https://skmtc.dev/folk/apis/folk-external-api/changes/v1/webhooks/post)