instantly-webhooks-events

# Instantly Webhooks & Events ## Overview Handle Instantly API v2 webhooks for real-time email outreach event notifications. Instantly fires events when emails are sent, opened, clicked, replied to, or bounced, and when leads change interest status. Webhooks require Hypergrowth plan ($97/mo) or higher. Delivery retries: **3 times within 30 seconds** on failure. ## Prerequisites - Instantly Hypergrowth plan or higher (required for webhooks) - API key with `all:all` or appropriate webhook scopes - Public HTTPS endpoint for receiving webhook payloads - `INSTANTLY_API_KEY` environment variable set ## Webhook Event Types | Event Type | Trigger | Key Payload Fields | |------------|---------|-------------------| | `email_sent` | Email delivered to recipient | `lead_email`, `campaign_id`, `step` | | `email_opened` | Recipient opens email | `lead_email`, `campaign_id`, `open_count` | | `email_link_clicked` | Recipient clicks a link | `lead_email`, `campaign_id`, `link_url` | | `reply_received` | Recipient replies | `lead_email`, `campaign_id`, `reply_text` | | `email_bounced` | Email bounces | `lead_email`, `bounce_type`, `reason` | | `lead_unsubscribed` | Lead unsubscribes | `lead_email`, `campaign_id` | | `campaign_completed` | All leads in campaign processed | `campaign_id`, `campaign_name` | | `account_error` | Sending account error | `email`, `error_type` | | `lead_interested` | Lead marked interested | `lead_email`, `campaign_id` | | `lead_not_interested` | Lead marked not i...