---
title: "Changes to Create Webhook"
method: POST
path: "/v0/webhooks"
---

# Changes to Create Webhook

`POST /v0/webhooks`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 4 of 38 revisions.

- **2026-10-16** `3f5c7830c952`: 3 breaking, 11 warning, 10 info
- **2026-07-15** `394ddcdd9c29`: 1 breaking, 4 warning, 4 info
- **2026-05-01** `ce126eb1243c`: 1 warning, 1 info
- **2026-04-08** `69e3767c5ada`: 2 warning, 2 info

## Changes

- **2026-10-16** `3f5c7830c952`: 3 breaking, 11 warning, 10 info
  - added the new required request property `event_types`
  - added the new required request property `url`
  - the request property `pod_ids` became not nullable
  - removed `#/components/schemas/webhooksCreatePodWebhookRequest` from the request body `allOf` list
  - added the new `calendar.event.created` enum value to the `event_types/items/` response property for the response status `200`
  - added the new `calendar.event.deleted` enum value to the `event_types/items/` response property for the response status `200`
  - added the new `calendar.event.ending` enum value to the `event_types/items/` response property for the response status `200`
  - added the new `calendar.event.responded` enum value to the `event_types/items/` response property for the response status `200`
  - added the new `calendar.event.starting` enum value to the `event_types/items/` response property for the response status `200`
  - added the new `calendar.event.updated` enum value to the `event_types/items/` response property for the response status `200`
  - added the new `message.opened` enum value to the `event_types/items/` response property for the response status `200`
  - added the new `message.security.completed` enum value to the `event_types/items/` response property for the response status `200`
  - added the new `message.security.override` enum value to the `event_types/items/` response property for the response status `200`
  - added the new `message.security.review` enum value to the `event_types/items/` response property for the response status `200`
  - the endpoint scheme security `Bearer` was added to the API
  - the endpoint scheme security `BearerAuth` was removed from the API
  - api tag `webhooks` added
  - api tag `Webhooks` removed
  - added the new optional request property `client_id`
  - added the new optional request property `headers`
  - added the new optional request property `inbox_ids`
  - request body became optional
  - added the optional property `inbox_id` to the response with the `200` status
  - added the optional property `pod_id` to the response with the `200` status
- **2026-07-15** `394ddcdd9c29`: 1 breaking, 4 warning, 4 info
  - added `#/components/schemas/webhooksCreatePodWebhookRequest` to the request body `allOf` list
  - removed the request property `client_id`
  - removed the request property `event_types`
  - removed the request property `inbox_ids`
  - removed the request property `url`
  - added the optional property `code` to the response with the `400` status
  - added the optional property `docs` to the response with the `400` status
  - added the optional property `fix` to the response with the `400` status
  - added the optional property `message` to the response with the `400` status
- **2026-05-01** `ce126eb1243c`: 1 warning, 1 info
  - added the new `message.received.unauthenticated` enum value to the `event_types/items/` response property for the response status `200`
  - added the new `message.received.unauthenticated` enum value to the request property `event_types/items/`
- **2026-04-08** `69e3767c5ada`: 2 warning, 2 info
  - added the new `message.received.blocked` enum value to the `event_types/items/` response property for the response status `200`
  - added the new `message.received.spam` enum value to the `event_types/items/` response property for the response status `200`
  - added the new `message.received.blocked` enum value to the request property `event_types/items/`
  - added the new `message.received.spam` enum value to the request property `event_types/items/`

---

[Operation](https://skmtc.dev/agentmail-to/apis/api/docs/v0/webhooks/post.md) - [API](https://skmtc.dev/agentmail-to/apis/api.md) - [Page](https://skmtc.dev/agentmail-to/apis/api/changes/v0/webhooks/post)