---
title: "Create an event webhook"
method: POST
path: "/v1/event-webhooks"
tags: ["Event Webhooks"]
---

# Create an event webhook

`POST /v1/event-webhooks`

Creates an event webhook for a supported product area.

## Request body

- union
  - EventWebhookCreateImporterRequest
    - `webhook_key` string, required — A unique (per-org) key identifying this event webhook.
    - `product_area` 'importer', required — Product area that owns the event webhook.
    - `url` string, required — The HTTPS URL that OneSchema will POST event payloads to.
    - `description` string, nullable — Optional human-readable description. Defaults to an empty string.
    - `events` EventWebhookImporterEventType[] — Importer event types to subscribe to. Defaults to an empty array.
    - `secret_key` string, nullable — Optional shared secret sent using HTTP Basic authentication.
  - EventWebhookCreateMultiFileFeedsRequest
    - `webhook_key` string, required — A unique (per-org) key identifying this event webhook.
    - `product_area` 'multi_file_feeds', required — Product area that owns the event webhook.
    - `url` string, required — The HTTPS URL that OneSchema will POST event payloads to.
    - `description` string, nullable — Optional human-readable description. Defaults to an empty string.
    - `events` EventWebhookMultiFileFeedEventType[] — Multi FileFeed event types to subscribe to. Defaults to an empty array.
    - `secret_key` string, nullable — Optional shared secret sent using HTTP Basic authentication.

## Response `201`

Created

- EventWebhookResource
  - `id` integer — The unique identifier of the event webhook.
  - `webhook_key` string — The org-unique key identifying this event webhook.
  - `product_area` 'importer' | 'multi_file_feeds' — Product area that owns the event webhook.
  - `url` string — The HTTPS URL that OneSchema will POST event payloads to.
  - `description` string — Optional human-readable description.
  - `events` EventWebhookEventType[] — Event types subscribed to by this webhook.

## Other responses

- `400` — Bad request
- `401` — Unauthorized (missing or invalid API key)
- `403` — Forbidden

---

[API](https://skmtc.net/oneschema/apis/templates.md) · [All operations](https://skmtc.net/oneschema/apis/templates/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/oneschema/templates/revisions/40674aa6d4d9/schema)