INinstantly
Webhook

Patch webhook

Requires one of the following scopes: webhooks:update, webhooks:all, all:update, all:all

patch/api/v2/webhooks/{id}

Request

  • Base URL
    https://api.instantly.ai
  • URL
    https://api.instantly.ai/api/v2/webhooks/{id}
  • Auth
    HTTP bearer

Path parameters

idstring uuid required
Example:01a19e6f-8e60-7b00-8e03-41194d9c2fb9

The ID of the item to update

Request body

campaignstring uuid nullable

Optional campaign UUID to filter events (null = all campaigns in workspace)

namestring nullable

Optional user-defined name for the webhook

target_hook_urlstring uri

Target URL to send webhook payloads

event_type'all_events' | 'email_sent' | 'email_opened' | 'email_link_clicked' | 'reply_received' | 'email_bounced' | 'lead_unsubscribed' | 'campaign_completed' | 'account_error' | 'lead_neutral' | 'lead_interested' | 'lead_not_interested' | 'lead_meeting_booked' | 'lead_meeting_completed' | 'lead_closed' | 'lead_out_of_office' | 'lead_wrong_person' | 'lead_no_show' | 'supersearch_enrichment_completed' nullable

Type of event to trigger the webhook (null for custom label events). Set to "all_events" to subscribe to all events - including custom label events

custom_interest_valuenumber nullable

Custom interest value - corresponds to LeadLabel.interest_status (used for custom label events)

headersobject nullable

Optional HTTP headers to include when delivering webhook payloads (key-value pairs)

Example request

{
  "campaign": "01a19e6f-50e1-7355-9e55-9089589190dc",
  "name": "Zapier Positive Replies",
  "target_hook_url": "https://webhook.site/unique-url",
  "event_type": "email_sent",
  "custom_interest_value": 1,
  "headers": {
    "Authorization": "Basic dXNlcm5hbWU6cGFzc3dvcmQ="
  }
}

Response

The updated Webhook

idstring uuid required

Unique identifier for the webhook (UUID)

organizationstring uuid required

Organization (workspace) UUID that owns this webhook

campaignstring uuid nullable

Optional campaign UUID to filter events (null = all campaigns in workspace)

namestring nullable

Optional user-defined name for the webhook

target_hook_urlstring uri required

Target URL to send webhook payloads

event_type'all_events' | 'email_sent' | 'email_opened' | 'email_link_clicked' | 'reply_received' | 'email_bounced' | 'lead_unsubscribed' | 'campaign_completed' | 'account_error' | 'lead_neutral' | 'lead_interested' | 'lead_not_interested' | 'lead_meeting_booked' | 'lead_meeting_completed' | 'lead_closed' | 'lead_out_of_office' | 'lead_wrong_person' | 'lead_no_show' | 'supersearch_enrichment_completed' nullable

Type of event to trigger the webhook (null for custom label events). Set to "all_events" to subscribe to all events - including custom label events

custom_interest_valuenumber nullable

Custom interest value - corresponds to LeadLabel.interest_status (used for custom label events)

headersobject nullable

Optional HTTP headers to include when delivering webhook payloads (key-value pairs)

timestamp_createdstring date-time required

Timestamp when the webhook was created

statusnumber nullable

Webhook status: 1 = active, -1 = error (disabled due to delivery failures)

timestamp_errorstring date-time nullable

Timestamp when webhook was disabled due to delivery failures (null if active)

Example response

{
  "id": "01a19e6f-50e1-7355-9e55-90879476f6ce",
  "organization": "01a19e6f-50e1-7355-9e55-90884b714c02",
  "campaign": "01a19e6f-50e1-7355-9e55-9089589190dc",
  "name": "Zapier Positive Replies",
  "target_hook_url": "https://webhook.site/unique-url",
  "event_type": "email_sent",
  "custom_interest_value": 1,
  "headers": {
    "Authorization": "Basic dXNlcm5hbWU6cGFzc3dvcmQ="
  },
  "timestamp_created": "2026-11-02T22:44:17.761Z",
  "status": 1,
  "timestamp_error": "2026-11-02T22:44:17.761Z"
}

Changes

No recorded changes to this operation across all 6 revisions of this API.