---
title: "Create a webhook"
method: POST
path: "/webhooks"
tags: ["Webhooks"]
---

# Create a webhook

`POST /webhooks`

## Request body

- CreateWebhook
  - `url` string, url, required — URL of the webhook
  - `description` string — Description of the webhook
  - `events` string[], required — - Events triggering the webhook. Possible values for **Transactional** type webhook: #### `sent` OR `request`, `delivered`, `hardBounce`, `softBounce`, `blocked`, `spam`, `invalid`, `deferred`, `click`, `opened`, `uniqueOpened` and `unsubscribed` - Possible values for **Marketing** type webhook: #### `spam`, `opened`, `click`, `hardBounce`, `softBounce`, `unsubscribed`, `listAddition` & `delivered` - Possible values for **Inbound** type webhook: #### `inboundEmailProcessed`
  - `type` 'transactional' | 'marketing' | 'inbound' — Type of the webhook
  - `domain` string — Inbound domain of webhook, required in case of event type `inbound`
  - `batched` boolean — To send batched webhooks
  - `auth` GetWebhookAuth — Add authentication on webhook url
    - `type` string — Type of authentication
    - `token` string — Webhook authentication token
  - `headers` GetWebhookHeaders[] — Custom headers to be send with webhooks
    - `key` string — Header key name
    - `value` string — Header value

## Response `201`

Webhook created

- CreateModel
  - `id` integer, required — ID of the object created

## Other responses

- `400` — bad request

---

[API](https://skmtc.net/getbrevo/apis/brevo-api.md) · [All operations](https://skmtc.net/getbrevo/apis/brevo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getbrevo/brevo-api/revisions/2aec3cf66501/schema)