---
title: "Create Webhook"
method: POST
path: "/webhooks"
tags: ["Events + Webhooks"]
---

# Create Webhook

`POST /webhooks`

## Headers

- `LMG-Data-Privacy-Access-Principal` string, required
- `LMG-Data-Privacy-Access-Justification` string, required

## Request body

- CreateWebhookRequest — An object representing a webhook to be registered.
  - `url` string, uri, required — The URL of your webhook endpoint to be invoked when an event occurs.
  - `events` EventType[], required

## Response `201`

Successful Response

- Webhook — An object representing a registered webhook.
  - `id` string, required — A string representing a webhook's unique identifier.
  - `url` string, uri, required — The URL registered to receive webhook notifications.
  - `events` EventType[], required
  - `signature_secret` string, required — Shared secret used to calculate the signature in the HTTP header Lemon-Markets-Signature for requests posted to the webhook URL.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `422` — Unprocessable Entity
- `5XX` — Server Error

---

[API](https://skmtc.net/lemon/apis/lemon-markets-brokerage-api.md) · [All operations](https://skmtc.net/lemon/apis/lemon-markets-brokerage-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lemon/lemon-markets-brokerage-api/versions/3c8cfd3a96c9/schema)