---
title: "POST /webhook"
method: POST
path: "/webhook"
---

# POST /webhook

`POST /webhook`

Create a webhook configuration to receive realtime events for payments, intents, subscriptions, payouts, or setup methods.

## Headers

- `Idempotency-Key` string

## Request body

- CreateWebhookRequest
  - `eventSigner` string, required — Secret used to sign outbound webhook events. Provide a value that you will use to verify the signature.
  - `endpoint` string, required — Public **HTTPS** URL where **xPay** should `POST` webhook events.
  - `subscribedEventTypes` string[], required — List of event types to subscribe to. Refer to [webhook events](/developer-resources/webhooks/events-list) for the full list of available events.

## Response `200`

Webhook configuration created successfully. Returns the identifier of the newly created webhook.

- CreateWebhookResponse — Response payload returned after successfully creating a webhook configuration.
  - `webhookConfigId` string, required — Identifier of the newly created webhook configuration.

## Other responses

- `204` — Webhook configuration created successfully. No content is returned.
- `400` — Invalid request

---

[API](https://skmtc.net/xpaycheckout/apis/xpay-api-store.md) · [All operations](https://skmtc.net/xpaycheckout/apis/xpay-api-store/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/xpaycheckout/xpay-api-store/versions/6329a7c694bc/schema)