---
title: "Create a webhook endpoint"
method: POST
path: "/api/v1/webhooks"
tags: ["Webhooks"]
---

# Create a webhook endpoint

`POST /api/v1/webhooks`

## Request

- Base URL: `https://namesniper.pro`
- URL: `https://namesniper.pro/api/v1/webhooks`
- Auth: HTTP bearer

Requires Pro or Business plan. The signing secret is returned only at creation.

## Request body

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

## Response `200`

Created webhook (includes the signing secret).

- object
  - `success` unknown
  - `data` WebhookWithSecret: Returned only at creation. The secret signs the HMAC-SHA256 payload header and is never shown again.
    - `id` string
    - `url` string, uri
    - `events` WebhookEvent[]
    - `active` boolean
    - `secret` string
    - `createdAt` string, date-time

## Other responses

- `400`: Invalid request (missing field, bad JSON, or invalid value).
- `401`: Missing or invalid API key.
- `403`: Authenticated but not permitted (revoked key or a feature your plan does not include).

---

[API](https://skmtc.dev/namesniper/apis/namesniper-api.md) · [All operations](https://skmtc.dev/namesniper/apis/namesniper-api/llms.txt) · [OpenAPI document](https://skmtc.dev/namesniper/apis/namesniper-api/revisions/fd6bfd6608b2?raw)