---
title: "Create webhook"
method: POST
path: "/s2s/webhooks"
tags: ["S2S Webhooks"]
---

# Create webhook

`POST /s2s/webhooks`

Register a webhook endpoint. The signing secret is returned exactly once.

## Request body

- S2SWebhookCreateBody
  - `url` string, required
  - `events` string[] — Event types to deliver; omit for all.
  - `description` string

## Response `201`

Created

- S2SWebhookListItem
  - `id` string, required
  - `url` string, required
  - `enabled` boolean, required
  - `events` string[], required
  - `description` string
  - `secret` string, required — Masked; the full secret is returned once at creation.
  - `createdAt` string, date-time, required

---

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