---
title: "Create webhook"
method: POST
path: "/api/v2/arbitrum/webhooks"
tags: ["Arbitrum Webhooks"]
---

# Create webhook

`POST /api/v2/arbitrum/webhooks`

Creates a new webhook for real-time communication and event notification.

## Headers

- `X-Network` 'testnet' | 'mainnet'
- `Authorization` string, required
- `Content-Type` 'application/json' | 'application/x-www-form-urlencoded' | 'multipart/form-data', required

## Request body

- object
  - `from` string — Sender address (required if not "to"). This field is required when <code>to</code> is not present. Must match the regex /^0x[a-fA-F0-9]{40}$/.
  - `to` string — Receiver address (required if not providing "from"). This field is required when <code>from</code> is not present. Must match the regex /^0x[a-fA-F0-9]{40}$/.
  - `url` string, required — URL for webhook notifications (required). Must be a valid URL.
  - `contractaddress` string — The Address of an Contract you want to track (Not allowwed on Bitcoin). This field is required when none of <code>from</code> and <code>to</code> are present. Must match the regex /^0x[a-fA-F0-9]{40}$/.
  - `token_id` string — This field is required when none of <code>from</code> and <code>to</code> are present.
  - `type` 'ETH' | 'ERC20' | 'ERC721'
  - `reference` string, nullable — A reference for the webhook. Must not be greater than 255 characters.

## Response `201`

- object
  - `status` integer
  - `ok` boolean
  - `message` string
  - `data` object
    - `webhook` string

## Other responses

- `422`

---

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