# Botmail Webhooks API

**Canonical:** https://apis.io/apis/botmail-pro/botmail-pro-webhooks-api/  
**Provider:** Botmail — https://apis.io/providers/botmail-pro/  
**Base URL:** https://botmail.pro  
**Documentation:** https://botmail.pro/v1/openapi.yaml

Botmail Webhooks API is one of 10 APIs that [Botmail](https://apis.io/providers/botmail-pro/) 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.

Push events to your HTTPS endpoint. **Delivery**: `POST` with a JSON `WebhookEvent` body (`{id: "evt_<seq>", type, mailbox_id, thread_id, message_id, created_at, data}`). **Headers**: - `Botmail-Event-Id`: the event id (`evt_<seq>`); use it to de-duplicate. - `Botmail-Signature: t=<unix seconds>,v1=<hex>` where `v1 = hex(HMAC-SHA256(secret, t + "." + raw_body))`. Verify against the raw request bytes and reject stale `t`. **Success** is any 2xx within 10 seconds. Failures are retried with exponential backoff (5 s, doubling, max 1 h). Events are delivered in order per webhook, so one failing event blocks later ones. After 20 consecutive failures the webhook is disabled (`active: false`, `disabled_reason` set); re-enable with `PATCH {active: true}`.

## Operations (6)

| Method | Path | Summary |
|---|---|---|
| POST | `/v1/webhooks` | Create a webhook |
| GET | `/v1/webhooks` | List webhooks |
| PATCH | `/v1/webhooks/{id}` | Update a webhook |
| DELETE | `/v1/webhooks/{id}` | Delete a webhook |
| POST | `/v1/webhooks/{id}/test` | Send a test event |
| GET | `/v1/webhooks/{id}/deliveries` | Recent delivery attempts |

## Machine-readable artifacts (1)

- **OpenAPI** — https://artifacts.apis.io/botmail-pro/openapi/botmail-pro-webhooks-api-openapi.yml

## Other Botmail APIs (9)

- [Botmail Account API](https://apis.io/apis/botmail-pro/botmail-pro-account-api/)
- [Botmail Billing API](https://apis.io/apis/botmail-pro/botmail-pro-billing-api/)
- [Botmail Claim API](https://apis.io/apis/botmail-pro/botmail-pro-claim-api/)
- [Botmail Events API](https://apis.io/apis/botmail-pro/botmail-pro-events-api/)
- [Botmail Keys API](https://apis.io/apis/botmail-pro/botmail-pro-keys-api/)
- [Botmail Mail API](https://apis.io/apis/botmail-pro/botmail-pro-mail-api/)
- [Botmail Mailboxes API](https://apis.io/apis/botmail-pro/botmail-pro-mailboxes-api/)
- [Botmail Meta API](https://apis.io/apis/botmail-pro/botmail-pro-meta-api/)
- [Botmail Send API](https://apis.io/apis/botmail-pro/botmail-pro-send-api/)

## Tags

Webhook

---

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