---
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`

## Response `201`

Webhook created

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

## Other responses

- `400` — bad request

---

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