Skip to main content
POST
Create webhook

Authorizations

Authorization
string
header
required

API token from your Timeless dashboard.

Body

application/json
url
string
required

The HTTPS URL that will receive webhook events. Must be publicly accessible. Max 2048 characters.

Maximum string length: 2048
Example:

"https://example.com/webhooks/timeless"

events
enum<string>[]
required

List of events to subscribe to. At least one event is required.

Minimum array length: 1
Available options:
meeting.transcript_ready,
meeting.initial_summary_ready
enabled
boolean
default:true

Whether the webhook is active. Set to false to create it in a disabled state.

Response

The created webhook including the signing secret.

id
string
required

Webhook ID.

Example:

"whk_abc123"

url
string
required

The registered URL.

events
enum<string>[]
required

Subscribed events.

Available options:
meeting.transcript_ready,
meeting.initial_summary_ready
enabled
boolean
required

Whether the webhook is active.

created_at
string<date-time>
required

ISO 8601 timestamp.

updated_at
string<date-time>
required

ISO 8601 timestamp.

secret
string
required

HMAC signing secret. Store this securely — it is only returned on creation.

Example:

"a1b2c3d4e5f6..."