---
title: "Creates a webhook"
method: POST
path: "/v1/webhooks"
tags: ["webhooks"]
---

# Creates a webhook

`POST /v1/webhooks`

Creates a webhook

## Query parameters

- `teamId` string
- `slug` string

## Request body

- object
  - `url` string, uri, required
  - `events` string[], required
  - `projectIds` string[]

## Response `200`

- object
  - `secret` string, required — The webhook secret used to sign the payload
  - `events` string[], required — The webhooks events
  - `id` string, required — The webhook id
  - `url` string, required — A string with the URL of the webhook
  - `ownerId` string, required — The unique ID of the team the webhook belongs to
  - `createdAt` number, required — A number containing the date when the webhook was created in in milliseconds
  - `updatedAt` number, required — A number containing the date when the webhook was updated in in milliseconds
  - `projectIds` string[] — The ID of the projects the webhook is associated with

## Other responses

- `400` — One of the provided values in the request body is invalid.
- `401` — The request is not authorized.
- `403` — You do not have permission to access this resource.
- `410`

---

[API](https://skmtc.net/vercel/apis/api.md) · [All operations](https://skmtc.net/vercel/apis/api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vercel/api/versions/61d1ba3f6dac/schema)