INinstantly
Webhook

Get webhook

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

get/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:01a19e6d-9306-7650-ac63-59a855874fd0

The ID of the requested item

Response

The requested 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": "01a19e6d-511d-7922-bf22-88a43b3c7f7e",
  "organization": "01a19e6d-511d-7922-bf22-88a5609f2c91",
  "campaign": "01a19e6d-511d-7922-bf22-88a6499e6250",
  "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:42:06.749Z",
  "status": 1,
  "timestamp_error": "2026-11-02T22:42:06.749Z"
}

Changes

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