Create a webhook
Endpoints
Create a webhook
Register a webhook subscription. The signing secret is returned only in this response.
Scope: write:webhooks
POST
Create a webhook
Authorizations
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
HTTPS only; may not resolve to a private/reserved address.
Maximum string length:
500Subscribed events, or ["*"].
Minimum array length:
1Available options:
company.created, company.updated, contact.created, contact.updated, contact.deleted, signal.created, member.invited, member.joined Optional custom headers (e.g. an auth token). Reserved/signing headers are rejected. Max 20, 4KB total.
Maximum string length:
255Response
Webhook created (includes the one-time secret).
Last modified on July 6, 2026