Skip to main content
POST
Create a webhook

Authorizations

Authorization
string
header
required

User API token from Settings → Public API. Access is restricted by scopes and workspace selection.

Path Parameters

Body

application/json
name
string
required
Example:

"Ranklybee"

url
string
required

Public HTTPS endpoint that receives signed events.

Example:

"https://api.example.com/webhooks/postlybee"

events
string[]

Event types to receive; omit or pass [] for every type.

Example:
integrationIds
string[]

Limit to these connected account IDs; omit for all.

Response

id
string
required
Example:

"9b2f1c7e-6a1d-4f5b-8c3e-2d4a6b8c0e1f"

name
string
required
Example:

"Ranklybee"

url
string
required
Example:

"https://api.example.com/webhooks/postlybee"

events
string[]
required

Subscribed event types; empty means every type.

Example:
integrations
object[]
required

Connected accounts this subscription is limited to; empty means all.

disabled
boolean
required
Example:

false

disabledReason
string | null
required
Example:

null

createdByKind
enum<string>
required
Available options:
dashboard,
api_token,
oauth_client
consecutiveFailures
number
required
Example:

0

lastSuccessAt
string | null
required
Example:

"2026-10-03T09:00:12.000Z"

createdAt
string
required
Example:

"2026-10-01T08:00:00.000Z"

secret
string
required

Signing secret. Returned only once; store it securely.

Example:

"whsec_MfKQ9r8GKYqrTwjUPD8ILPZIo2LaLaSw"

Last modified on October 3, 2026