Skip to main content
POST
Create a webhook endpoint
Register an HTTPS URL to receive signed events when generations reach a terminal state. See Webhooks for the event payload shape and signature verification.
The response includes the signing secret — shown once. Store it securely before discarding the response.

Authorizations

Authorization
string
header
required

Your Selektable API key (selektable_...), sent as Authorization: Bearer <key>.

Body

application/json
url
string<uri>
required

HTTPS destination URL.

description
string
Maximum string length: 200
enabledEvents
enum<string>[]
Available options:
*,
generation.completed,
generation.failed

Response

Endpoint created (includes one-time secret)

id
string
Example:

"whe_abc123"

object
enum<string>
Available options:
webhook_endpoint
url
string<uri>
description
string | null
enabledEvents
string[]
status
enum<string>
Available options:
enabled,
disabled
createdAt
string<date-time>
updatedAt
string<date-time>
secret
string

Signing secret. Shown only once — store it securely.

Example:

"whsec_..."