Create a webhook endpoint

post

https://zyins.isaapi.com/v1/webhook_endpoints

Creates a new webhook endpoint for the authenticated account. The signing secret is returned only at creation time; store it immediately.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

url

uri

required

HTTPS URL to receive event POSTs. Must use HTTPS.

events

array of strings

Event types to subscribe to. Empty or omitted subscribes to all events.

events

description

string

Optional label for this endpoint.

Headers

Idempotency-Key

string

Client-supplied idempotency token for mutating versioned API requests (POST, PUT, PATCH, DELETE under /v1/* and /v2/* where listed).

When the service has already completed a request for the same account, route, key, and identical JSON body within the replay window, it returns the stored HTTP status and body instead of executing again.

Reusing the same key with a different body returns 409 Conflict (see 409 / Idempotency conflict responses on those operations). Keys expire after 24 hours. Prefer a new UUID v4 per distinct logical operation.

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

201Endpoint created. The signing_secret is present only in this response.

409Idempotency key reused with a different request body than the completed replay entry for the same account, endpoint, and key.

422Validation error (missing url, non-HTTPS url).

defaultInternal server error