---
title: "Create a webhook"
method: POST
path: "/v4/webhooks"
tags: ["Webhooks"]
---

# Create a webhook

`POST /v4/webhooks`

Available event types:<br/>- `subscriber.subscriber_activate`<br/>- `subscriber.subscriber_unsubscribe`<br/>- `subscriber.subscriber_bounce`<br/>- `subscriber.subscriber_complain`<br/>- `subscriber.form_subscribe`, required parameter `form_id` [Integer]<br/>- `subscriber.course_subscribe`, required parameter `sequence_id` [Integer]<br/>- `subscriber.course_complete`, required parameter `sequence_id` [Integer]<br/>- `subscriber.link_click`, required parameter `initiator_value` [String] as a link URL<br/>- `subscriber.product_purchase`, required parameter `product_id` [Integer]<br/>- `subscriber.tag_add`, required parameter `tag_id` [Integer]<br/>- `subscriber.tag_remove`, required parameter `tag_id` [Integer]<br/>- `purchase.purchase_create`<br/>- `custom_field.field_created`<br/>- `custom_field.field_deleted`<br/>- `custom_field.field_value_updated`, required parameter `custom_field_id` [Integer]

## Request body

- object
  - `target_url` string, required
  - `event` object, required
    - `name` string, required
    - `form_id` unknown, required
    - `tag_id` unknown, required
    - `sequence_id` unknown, required
    - `product_id` unknown, required
    - `initiator_value` unknown, required
    - `custom_field_id` unknown

## Response `201`

Creates the webhook

- object
  - `webhook` object, required
    - `id` integer, required
    - `account_id` integer, required
    - `event` object, required
      - `name` string, required — Product name
      - `initiator_value` unknown, required
    - `target_url` string, required

## Other responses

- `401` — Returns a 401 if the token and/or account cannot be authenticated
- `422` — Returns an error when missing required params

---

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