Sign in

v1

latestOpenAPI 3.1.02026-07-26359254.7 MB
Webhooks

Update a webhook subscription

<small>Requires the webhooks:write scope (or a broader one that includes it).</small>

Full replacement of the mutable fields of an existing subscription. organization scope is rejected with code: webHook.organizationScopeNotImplemented.

put/v3/webhooks/{id}

Path parameters

idinteger required

Webhook subscription ID.

Request body

eventTypestring required

Event type this subscription should fire on. Must be one of the values returned by GET /v3/webhooks/events.

urlstring uri required

Absolute http/https URL that will receive the webhook payload.

scope'personal' | 'team' | 'organization' required

Scope that determines which users' activity triggers the webhook.

  • personal — fires only for activity of the subscription owner.
  • team — fires for activity of any member of the owner's team. Creation requires the current user to be the team owner for private teams; anyone can create for public teams.
  • organization — reserved for future use. The API currently rejects creation/update with this value (errorCode: 5).

Example request

{
  "eventType": "email_replied",
  "url": "https://example.com/hooks/reply-v2",
  "scope": "personal",
  "payloadConfig": {
    "includeEmailUrl": true,
    "includeEmailText": true,
    "includeProspectCustomFields": true
  }
}

Response

Webhook subscription updated successfully.

idinteger

Unique identifier for the webhook subscription.

eventTypestring

Event type this subscription fires on. One of the values returned by GET /v3/webhooks/events.

urlstring uri

Absolute http/https URL that receives the webhook payload.

scope'personal' | 'team' | 'organization'

Scope that determines which users' activity triggers the webhook.

  • personal — fires only for activity of the subscription owner.
  • team — fires for activity of any member of the owner's team. Creation requires the current user to be the team owner for private teams; anyone can create for public teams.
  • organization — reserved for future use. The API currently rejects creation/update with this value (errorCode: 5).
enabledboolean

If false, the subscription does not fire. Toggle via the dedicated POST /v3/webhooks/{id}/enable and POST /v3/webhooks/{id}/disable endpoints — the state cannot be changed through PUT.

createdAtstring date-time

ISO-8601 timestamp (UTC) when the subscription was created.

Example response

{
  "id": 1823,
  "eventType": "email_replied",
  "url": "https://example.com/hooks/reply",
  "scope": "personal",
  "enabled": true,
  "createdAt": "2026-04-17T12:00:00+00:00",
  "payloadConfig": {
    "includeEmailUrl": true,
    "includeEmailText": false,
    "includeProspectCustomFields": true
  }
}