S2S Webhooks

Create webhook

POST

https://api.gleap.io/v3/s2s/webhooks

Authorizations

Authorizationstring · headerrequired

Bearer authentication header of the form Bearer <token>.

Bodyapplication/jsonrequired

urlstringrequired

eventsstring[]

Event types to deliver; omit for all.

descriptionstring

Response

application/json

Created

idstringrequired

urlstringrequired

enabledbooleanrequired

eventsstring[]required

descriptionstring

secretstringrequired

Masked; the full secret is returned once at creation.

createdAtstring<date-time>required

Updated November 1, 2026

curl --request POST \
  --url https://api.gleap.io/v3/s2s/webhooks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "url": "<url>"
}'

{
  "id": "string",
  "url": "string",
  "enabled": true,
  "events": [
    "string"
  ],
  "description": "string",
  "secret": "string",
  "createdAt": "2026-01-01T12:00:00Z"
}