---
title: "Add Handler"
method: POST
path: "/webhook/add_handler"
tags: ["webhook"]
---

# Add Handler

`POST /webhook/add_handler`

Creates a new webhook handler

## Request body

- object
  - `type` string, required — Webhook event type. Common patterns: order.status.*, order.shipped, order.tracking, order.tags, item.inventory, item.updated, shipment.created, shipment.voided, purchase_order.*, transfer_order.*
  - `name` string, required — User-friendly name for the webhook handler
  - `handler` WebhookHandler, required — Webhook handler configuration
    - `url` string, uri, required — Webhook destination URL
    - `method` string, required — HTTP method for the webhook
    - `headers` object — Headers to send with the webhook

## Response `200`

Webhook handler created

- object
  - `success` boolean, required — Whether the operation succeeded

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden. Insufficient permissions.
- `429` — Too many requests. Rate limit exceeded.
- `500` — Internal server error.

---

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