---
title: "Create webhook"
method: POST
path: "/projects/{project_id}/webhooks"
tags: ["Webhooks"]
---

# Create webhook

`POST /projects/{project_id}/webhooks`

Creates a webhook for a project to receive HTTP notifications when content changes.

Deliveries use the `audio.updated` action type. See `#/components/examples/audioUpdatedWebhookDeliveryExample`
for a representative payload (media IDs are integers, `content_type` values are `mp3`/`m3u8`/`mp4`,
and `duration` is in seconds).

## Request body

- RequestBodyProjectWebhookCreate
  - `url` string, required — The URL that BeyondWords will send webhook notifications to. This URL must be served over HTTPS
  - `headers` object
  - `use_static_ip` boolean — Whether requests to URL should originate from a static IP address.
  - `enabled` boolean — Whether or not the webhook is enabled or disabled Has the value true if enabled. The default is true.

## Response `201`

successful

- ProjectWebhookModel
  - `id` integer — Unique identifier for the object
  - `url` string — The URL that BeyondWords will send webhook notifications to. This URL must be served over HTTPS
  - `headers` object
  - `enabled` boolean — Whether or not the webhook is enabled or disabled Has the value true if enabled. The default is true.
  - `use_static_ip` boolean — Whether requests to URL should originate from a static IP address.
  - `created` string, date-time — Time at which the object was created (ISO 8601)
  - `updated` string, date-time — Time at which the object was updated (ISO 8601)

---

[API](https://skmtc.net/beyondwords/apis/beyondwords-rest-api.md) · [All operations](https://skmtc.net/beyondwords/apis/beyondwords-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/beyondwords/beyondwords-rest-api/revisions/8c4bfe3e2ebd/schema)