Skip to main content
POST

Request Body

url
string
required
HTTPS URL to receive events
event_types
array
required
List of event types to subscribe to
agent_id
integer
default:"null"
Filter events to a specific agent (null = all agents)
description
string
default:"null"
Human-readable description
max_retries
integer
default:"3"
Number of retry attempts (0–5)
timeout_ms
integer
default:"5000"
Request timeout in milliseconds

Response

The secret is only returned on creation. Save it immediately — it cannot be retrieved later.

Errors

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
url
string
required
event_types
string[]
required
agent_id
integer | null
description
string | null
max_retries
integer
default:3
timeout_ms
integer
default:5000

Response

Successful Response