Skip to main content
POST
Create a webhook

Authorizations

X-API-Key
string
header
required

A compute API key (x402c_...). Mint one in the dashboard under Settings -> API Keys. This is the ONLY auth /pods/v1/* accepts - wallet signatures are bound to method+path+body and do not survive the internal hop, so signature callers must use the dashboard routes instead. Two extra scopes gate the dangerous powers: pods:wallet:write (pod wallet money, backup passphrase) and pods:control:write (connectors, full-power control socket).

Body

application/json
url
string<uri>
required

HTTPS only. Credentials in the URL, localhost, .internal/.local hosts and private IP literals are refused.

event_types
enum<string>[] | null

Omit for every event. An empty array is refused.

Available options:
pod.created,
pod.active,
pod.destroyed,
pod.destroy_failed,
pod.action.queued,
pod.status.changed,
pod.renewed,
pod.renewal_failed,
pod.expiring,
pod.backup.completed,
pod.backup.failed

Response

Webhook created. secret is shown once.

webhook
object