Application WebhooksCreate application webhook

Create application webhook

Creates a webhook configuration for the application. The application must belong to the authenticated merchant.

curl -X POST "https://api.example.com/api/v1/applications/example_string/webhooks" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN (JWT)" \
  -d '{
  "url": "https://merchant.example.com/hooks/kadosei"
}'
{
  "id": "8a1c2f9e-3d4b-4f5a-9b6c-7d8e9f0a1b2c",
  "url": "https://merchant.example.com/webhooks/kadosei",
  "isActive": true,
  "keyFingerprint": "whsec_****a3f2",
  "signingSecret": "whsec_full_secret_value",
  "subscribedEvents": [
    "session.completed",
    "session.expired"
  ],
  "lastTestAt": "2026-04-20T12:34:56.000Z",
  "lastTestStatus": "SUCCEEDED",
  "createdAt": "2026-01-15T08:00:00.000Z",
  "updatedAt": "2026-04-01T09:30:00.000Z"
}
POST
/api/v1/applications/{applicationId}/webhooks
POST
Base URLstring

Target server for requests. Edit to use your own host.

Bearer Token (JWT)
Bearer Tokenstring
Required

Bearer token (JWT) - just enter the token, "Bearer" prefix will be added automatically

path
applicationIdstring
Required

ID of the application that will own this webhook.

Content-Typestring
Required

The media type of the request body

Options: application/json
urlstring
Required

HTTPS endpoint on the merchant server that receives webhooks.

Request Preview
Response

Response will appear here after sending the request

Authentication

header
Authorizationstring
Required

Bearer token (JWT). Authentication token required.

Path Parameters

applicationIdstring
Required

ID of the application that will own this webhook.

Body

application/json
urlstring
Required

HTTPS endpoint on the merchant server that receives webhooks.

Example:
https://merchant.example.com/hooks/kadosei

Responses