# Cherami Webhooks API

**Canonical:** https://apis.io/apis/cherami-to/cherami-to-webhooks-api/  
**Provider:** Cherami — https://apis.io/providers/cherami-to/  
**Base URL:** https://cherami.to  
**Documentation:** https://cherami.to/docs/api

Cherami Webhooks API is one of 10 APIs that [Cherami](https://apis.io/providers/cherami-to/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 2 JSON Schema definitions. Tagged areas include Webhook. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 2 JSON Schemas.

The webhooks API from Cherami — 8 operation(s) for webhooks.

## Operations (12)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/webhooks` | List webhooks |
| POST | `/v1/webhooks` | Add a webhook |
| GET | `/v1/webhooks/events` | List recent events |
| GET | `/v1/webhooks/events/{event_id}` | Read one event's deliveries |
| GET | `/v1/webhooks/{webhook_id}` | Read a webhook |
| PATCH | `/v1/webhooks/{webhook_id}` | Edit a webhook |
| DELETE | `/v1/webhooks/{webhook_id}` | Delete a webhook |
| GET | `/v1/webhooks/{webhook_id}/secret` | Retrieve the signing secret |
| POST | `/v1/webhooks/{webhook_id}/secret/rotate` | Rotate the signing secret |
| GET | `/v1/webhooks/{webhook_id}/headers` | List custom header names |
| PATCH | `/v1/webhooks/{webhook_id}/headers` | Set or remove custom headers |
| GET | `/v1/webhooks/{webhook_id}/attempts` | List delivery attempts |

## Machine-readable artifacts (4)

- **OpenAPI** — https://artifacts.apis.io/cherami-to/openapi/cherami-to-webhooks-api-openapi.yml
- **Documentation** — https://cherami.to/docs/api
- **JSONSchema** — https://artifacts.apis.io/cherami-to/json-schema/cherami-to-created-webhook-schema.json
- **JSONSchema** — https://artifacts.apis.io/cherami-to/json-schema/cherami-to-webhook-schema.json

## Other Cherami APIs (9)

- [Cherami Access API](https://apis.io/apis/cherami-to/cherami-to-access-api/)
- [Cherami Drafts API](https://apis.io/apis/cherami-to/cherami-to-drafts-api/)
- [Cherami Feedback API](https://apis.io/apis/cherami-to/cherami-to-feedback-api/)
- [Cherami Inboxes API](https://apis.io/apis/cherami-to/cherami-to-inboxes-api/)
- [Cherami Labels API](https://apis.io/apis/cherami-to/cherami-to-labels-api/)
- [Cherami Messages API](https://apis.io/apis/cherami-to/cherami-to-messages-api/)
- [Cherami Sending API](https://apis.io/apis/cherami-to/cherami-to-sending-api/)
- [Cherami Threads API](https://apis.io/apis/cherami-to/cherami-to-threads-api/)
- [Cherami Trash API](https://apis.io/apis/cherami-to/cherami-to-trash-api/)

## Tags

Webhook

---

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