---
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 — The type of webhook to create
  - `name` string — A user-friendly name for the webhook handler
  - `handler` object
    - `url` string, uri — The URL the webhook should go to
    - `method` 'GET' | 'POST' | 'PUT' | 'DELETE' — The HTTP method to use for the webhook
    - `headers` object — The headers to send with the webhook
      - `authorization` string — Authorization header value

## Response `200`

OK

## Other responses

- `400` — Malformed request. Check that you have the correct parameters and that they are formatted correctly.
- `401` — Unauthorized. Did you forget to include your API key?

## Changes

- **2024-05-03** `4c3a56636b86` — 1 breaking, 3 info
  - the `handler` request property type/format changed from `string`/`` to `object`/``
  - added the new optional request property `handler/headers`
  - added the new optional request property `handler/method`
  - added the new optional request property `handler/url`
- **2024-04-23** `e4bdf6984278` — 1 info
  - endpoint added
- **2024-04-19** `46ceda528000` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/skulabs/apis/skulabs-api/changes/webhook/add_handler/post.md)

---

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