---
title: "Create Webhook"
method: POST
path: "/webhooks"
tags: ["webhooks"]
---

# Create Webhook

`POST /webhooks`

This endpoint creates a new webhook subscription

 Refer to the webhooks section to get the list of available integration names

## Request body

- object
  - `hookUrl` string, required — The URL where webhook events will be sent. Must be a valid HTTP or HTTPS URL
  - `integrationName` union, required — The integration name(s) to subscribe to. Can be a single string or an array of strings
    - string
    - string[]
  - `integrationMetadata` object — Optional metadata object for the webhook
  - `integrationType` string — The type of integration
  - `type` string — The webhook type
  - `name` string — Optional name for the webhook

## Response `201`

201 Created

- object
  - `id` string — Unique identifier of the webhook subscription
  - `subscribed_at` string — Timestamp when the webhook was subscribed
  - `is_subscribed` boolean — Whether the webhook is currently active
  - `integration_name` string — Name of the event this webhook listens to
  - `integration_type` string — Type of integration
  - `type` string — Type of the subscription
  - `integration_metadata` object — Additional metadata about the integration
    - `id` string — Metadata ID
    - `name` string — Metadata name or identifier
  - `org_id` string — Organization ID that owns this webhook
  - `hook_url` string — The URL where webhook events are sent
  - `integration_id` string — Unique identifier of the integration

---

[API](https://skmtc.net/periskope/apis/api-local.md) · [All operations](https://skmtc.net/periskope/apis/api-local/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/periskope/api-local/versions/f2738ced87d8/schema)