---
title: "Create Webhook"
method: POST
path: "/"
---

# Create Webhook

`POST /`

Create a new webhook subscription.

## Headers

- `X-API-Key` string, required

## Request body

- object
  - `callback_url` string, required — Your callback URL (HTTPS only) where webhook data will be sent.
  - `event_types` string[], required — List of event type identifiers for which to send notifications. See [Event Types](https://tokensniffer.readme.io/reference/event-types) for the list of available event types.
  - `secret` string, required — Secret phrase to use for SHA-256 encoding the notification request, ideally a random string of text with high entropy.
  - `filters` object — Object of filters. Currently supports "chain_id: <int>" and "chain_ids: list <int>"

## Response `200`

200

- object
  - `message` string
  - `subscription_id` string
  - `callback_url` string
  - `event_types` string[]
  - `created_at` string

## Other responses

- `400` — 400

---

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