---
title: "Create a new webhook"
method: POST
path: "/v1/integrations/webhooks"
tags: ["webhooks"]
---

# Create a new webhook

`POST /v1/integrations/webhooks`

## Query parameters

- `teamId` string

## Request body

- object
  - `name` string, required — A name to assign to the webhook
  - `url` string, required — The URL ZEIT will post to when events happen

## Response `201`

OK

- Webhook — A webhook subscription with an URL where ZEIT will POST events.
  - `id` string, required — Id of the webhook
  - `events` string[], required — An array with the event identifiers that the webhook can receive
  - `url` string, required — The URL where the POST request will be sent
  - `name` string, required — A name for the webhook that serves as a canonical description
  - `configurationId` string, required — An id that corresponds to the configuration that generated the token that was used to create the webhook
  - `createdAt` integer, required — Timestamp that tells when was the webhook created
  - `ownerId` string — Id of the owner which can be a user or a team

---

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