Skip to main content
POST
Create a webhook

Authorizations

Authorization
string
header
required

Bearer API key. Secret server keys start with gt_live_; client-safe browser keys start with gt_pub_ (write-only, origin-pinned). Create and scope keys in Settings → API Keys.

Body

application/json
url
string<uri>
required

HTTPS only; may not resolve to a private/reserved address.

Maximum string length: 500
events
(enum<string> | any)[]
required

Subscribed events, or ["*"].

Minimum array length: 1
Available options:
company.created,
company.updated,
contact.created,
contact.updated,
contact.deleted,
signal.created,
member.invited,
member.joined
headers
object

Optional custom headers (e.g. an auth token). Reserved/signing headers are rejected. Max 20, 4KB total.

description
string | null
Maximum string length: 255

Response

Webhook created (includes the one-time secret).

data
object
Last modified on July 7, 2026