v1

latestOpenAPI 3.1.02026-08-0411022.6 KB

Create Webhook

Create a new webhook subscription.

post/

Headers

X-API-Keystring required

Your assigned API key

Request body

callback_urlstring required

Your callback URL (HTTPS only) where webhook data will be sent.

event_typesstring[] required

List of event type identifiers for which to send notifications. See Event Types for the list of available event types.

secretstring required

Secret phrase to use for SHA-256 encoding the notification request, ideally a random string of text with high entropy.

filtersobject

Object of filters. Currently supports "chain_id: <int>" and "chain_ids: list <int>"

Response

200

messagestring

subscription_idstring

callback_urlstring

event_typesstring[]

created_atstring

Example response

{
  "message": "OK",
  "subscription_id": "1fe6b82a-db29-4880-86ad-f79c57724c72",
  "callback_url": "https://client.app/ts-webhook",
  "event_types": [
    "token.malicious"
  ],
  "created_at": "2025-11-26T20:47:38.161Z"
}