---
title: "Create a webhook"
method: POST
path: "/{account}/webhooks"
tags: ["webhooks"]
---

# Create a webhook

`POST /{account}/webhooks`

Registers a webhook endpoint.

## Path parameters

- `account` integer, required

## Request body

- object
  - `url` string, uri, required

## Response `201`

Successfully created a webhook.

- object
  - `data` Webhook
    - `id` integer
    - `url` string, uri
    - `suppressed_at` string, date-time — A date-time value formatted as ISO 8601.

## Other responses

- `400` — A required parameter is missing or the request is invalid.

## Changes

- **2023-07-18** (v2) `c8591dcf8c29` — 6 breaking
  - the response property `data` became optional for the status `201`
  - the response property `data/id` became optional for the status `201`
  - the response property `data/suppressed_at` became optional for the status `201`
  - the response property `data/url` became optional for the status `201`
  - …2 more

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

---

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