Skip to main content
GET
Get webhook

Authorizations

Authorization
string
header
required

Workspace API key from Settings → API Keys.

Path Parameters

webhook
string<uuid>
required

Webhook id. A webhook of another workspace returns 404.

Response

The webhook.

id
string<uuid>
endpoint
string<uri>
events
enum<string>[]
  • post.created: a post was created. Its data.status is the status it was created with (draft, scheduled, publishing or pending_approval).
  • post.scheduled: an existing post was scheduled (for example a draft scheduled, or a request approved). A post created already scheduled sends only post.created.
  • post.unscheduled: a scheduled post went back to draft or to pending approval.
  • post.published: every destination was published.
  • post.partially_published: some destinations were published and others failed.
  • post.failed: publishing failed.
  • post.deleted: a post was deleted. Not sent for posts imported from the network or removed by disconnecting their channel. Its data is only {id, workspace_id}.
Available options:
post.created,
post.scheduled,
post.unscheduled,
post.published,
post.partially_published,
post.failed,
post.deleted
status
enum<string>

paused is set by TryPost after 5 failed deliveries in a row (the account owner is emailed). Set status: enabled to resume.

Available options:
enabled,
disabled,
paused
last_sent_at
string<date-time> | null

ISO 8601, UTC.

Example:

"2026-10-08T14:00:03+00:00"

paused_at
string<date-time> | null

ISO 8601, UTC.

consecutive_failures
integer
signing_secret
string

Secret used to sign deliveries (whsec_ and 32 characters). Only returned when you create, get or rotate the webhook.

Example:

"whsec_4qXbV8kP2mT7nR1sW9yZ3cE6hJ0aL5dF"

created_at
string<date-time>

ISO 8601, UTC.

Example:

"2026-09-15T10:00:00+00:00"

updated_at
string<date-time>

ISO 8601, UTC.

Example:

"2026-10-08T14:00:03+00:00"