---
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, required
    - `id` integer, required
    - `url` string, uri, required
    - `suppressed_at` string, date-time, nullable, required — A nullable date-time value. The value can be null, when present the value is formatted according to the ISO 8601 specification.

## Other responses

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

---

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