---
title: "Create a new webhook"
method: POST
path: "/webhooks"
---

# Create a new webhook

`POST /webhooks`

Creates a new webhook with the specified details.

## Request body

- object
  - `callbackUrl` string, required — URL to which the webhook will send POST requests.
  - `events` string[], required — List of events the webhook is subscribing to.

## Response `201`

Successfully created webhook

- Webhook
  - `id` string, uuid
  - `callbackUrl` string
  - `events` string[] — List of events the webhook is subscribing to.
  - `createdAt` string, date-time
  - `updatedAt` string, date-time
  - `lastTriggeredAt` string, date-time

## Other responses

- `400` — Validation error

## Changes

- **2025-12-03** `8deefa349e1d` — 1 warning, 1 info
  - removed the optional property `createAt` from the response with the `201` status
  - added the optional property `createdAt` to the response with the `201` status

[Change history](https://skmtc.dev/argildotai/apis/argil-api/changes/webhooks/post.md)

---

[API](https://skmtc.dev/argildotai/apis/argil-api.md) · [All operations](https://skmtc.dev/argildotai/apis/argil-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/argildotai/argil-api/revisions/f3d0315da0f0/schema)