---
title: "Create Webhook"
method: POST
path: "/management/v1/projects/{projectId}/webhooks"
tags: ["Management"]
---

# Create Webhook

`POST /management/v1/projects/{projectId}/webhooks`

Creates a new webhook configuration.

> 📘 Webhook Documentation
>
> Read [Webhooks v2024-01-01](/api-reference/introduction-to-webhooks) article to learn how webhooks work in Voucherify.

## Request body

- ManagementProjectsWebhooksCreateRequestBody
  - `target_url` string — URL address that receives webhooks.
  - `events` string[] — Lists the events that trigger webhook sendout.
  - `active` boolean — Determines if the webhook configuration is active.

## Response `200`

Returns the details about the webhook configuration.

- ManagementProjectsWebhooksCreateResponseBody
  - `id` string, required — Unique identifier of the webhook.
  - `object` 'webhook', required — The type of the object represented by JSON.
  - `created_at` string, date-time, required — Timestamp representing the date and time when the webhook configuration was created. The value for this parameter is shown in the ISO 8601 format.
  - `target_url` string, required — URL address that receives webhooks.
  - `events` string[], required — Lists the events that trigger webhook sendout.
  - `active` boolean, required — Determines if the webhook configuration is active.

## Other responses

- `400` — Returns an error if the payload has incorrect values.
- `401` — Returns an error if an invalid token was provided.
- `402` — Returns an error if the current plan does not include the Management API feature.
- `404` — Returns an error when a resource could not be found.

---

[API](https://skmtc.net/voucherifyio/apis/voucherify-api-async-actions.md) · [All operations](https://skmtc.net/voucherifyio/apis/voucherify-api-async-actions/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/voucherifyio/voucherify-api-async-actions/revisions/4982266e0494/schema)