Create Webhook Subscription

Creates a new outbound webhook endpoint with SSRF protection and generates an HMAC SHA-256 secret (whsec_...) for payload verification.

post/api/v1/webhooks

Request

urlstring uri required

The destination URL to receive HTTPS POST event payloads.

eventsstring[]

List of event types to subscribe to.

descriptionstring

Optional human-readable label for this subscription (e.g. HubSpot Sync).

Webhook subscription created successfully. Contains the raw signing secret (shown only once).

messagestring

{
  "subscription": {
    "secret": "whsec_..."
  }
}