---
title: "Create Webhook"
method: POST
path: "/webhooks"
tags: ["Webhook APIs"]
---

# Create Webhook

`POST /webhooks`

Creates a new webhook configuration to receive notifications for one or more email events.  Each event must be mapped to a valid callback URL. Optional custom headers can be defined  to be sent with every webhook POST request.

## Headers

- `on-behalf-of` string

## Request body

- object
  - `events` object, required
    - `delivered` string — Test description
    - `open` string
    - `click` string
    - `bounce` string
    - `unsubscribe` string
    - `spam` string
    - `dropped` string
    - `invalid` string
    - `scheduled` string
    - `cancelled` string
  - `headers` object

## Response `200`

Webhook created successfully.

- object
  - `id` integer, required — Unique identifier for the created webhook.

## Other responses

- `400` — Bad Request – Validation failed or incorrect field formatting.
- `401` — Unauthorized – API key missing or invalid.
- `403` — Forbidden – You do not have access to create a webhook.
- `500` — Internal Server Error – An unexpected failure occurred.

---

[API](https://skmtc.dev/netcorecloud/apis/email-api-v6.md) · [All operations](https://skmtc.dev/netcorecloud/apis/email-api-v6/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/netcorecloud/email-api-v6/revisions/73f83bc2eff8/schema)