# Create webhook

> Creates a webhook endpoint subscribed to one or more event topics. The signing secret is returned only in this response — store it to verify delivery…

`POST /v2/api/webhooks`

<Note>
**Required scope:** `WEBHOOKS_READ_WRITE`
</Note>

Creates a webhook endpoint subscribed to one or more [event topics](/docs/webhooks/event-catalog).

- `url` must be a publicly reachable **HTTPS** URL.
- `topics` must contain at least one valid event type. Unknown topics return a `400` with code `INVALID_EVENT_TYPE`.
- The `signing_secret` is returned **only** in this response. Store it to [verify signatures](/docs/webhooks/verifying-signatures).
