instantly-observability

Instantly Observability

Overview

Monitor Instantly email outreach campaign health, deliverability metrics, and sending account reputation. Key signals include email deliverability rate, bounce rate, reply rate, open rate, sending volume vs daily limits, account warmup progress, and spam placement rate.

Prerequisites

• Instantly Growth or Hypergrowth plan
• API access with campaign read permissions
• Email deliverability monitoring (inbox placement tester recommended)

Instructions

Step 1: Track Campaign Metrics via API

set -euo pipefail
# Pull campaign performance data
curl "https://api.instantly.ai/api/v1/campaign/analytics?campaign_id=CAMP_ID" \
  -H "Authorization: Bearer $INSTANTLY_API_KEY" | \
  jq '{
    sent: .total_sent, delivered: .total_delivered, bounced: .total_bounced,
    opened: .total_opened, replied: .total_replied,
    bounce_rate: (.total_bounced / .total_sent * 100),
    reply_rate: (.total_replied / .total_sent * 100)
  }'

Step 2: Monitor Sending Account Health

// instantly-account-monitor.ts
async function monitorAccountHealth() {
  const accounts = await instantlyApi.getAccounts();
  for (const acct of accounts) {
    emitGauge('instantly_account_reputation', acct.reputation_score, { email: acct.email });
    emitGauge('instantly_daily_send_usage_pct', acct.sent_today / acct.daily_limit * 100, { email: acct.email });
    emitGauge('instantly_warmup_progress_pct', acct.warmup_progress, { email: acct.email });

    if (acct.reputation_score < 70) {
      console.warn(`Low reputation: ${acct.email} (score: ${acct.reputation_score})`);
    }
  }
}

Step 3: Set Deliverability Alerts

groups:
  - name: instantly
    rules:
      - alert: InstantlyHighBounceRate
        expr: instantly_bounce_rate > 5
        annotations: { summary: "Instantly bounce rate exceeds 5% -- check lead list quality" }
      - alert: InstantlyLowReputation
        expr: instantly_account_reputation < 60
        for: 1h
        annotations: { summary: "Sending account reputation below 60 on {{ $labels.email }}" }
      - alert: InstantlySendingCapNear
        expr: instantly_daily_send_usage_pct > 90
        annotations: { summary: "Sending account at 90% of daily limit" }
      - alert: InstantlyWarmupStalled
        expr: delta(instantly_warmup_progress_pct[24h]) == 0 and instantly_warmup_progress_pct < 100
        annotations: { summary: "Warmup progress stalled on {{ $labels.email }}" }

Step 4: Monitor Campaign Sequence Health

set -euo pipefail
# Check reply and bounce rates across all active campaigns
curl "https://api.instantly.ai/api/v1/campaign/list?status=active" \
  -H "Authorization: Bearer $INSTANTLY_API_KEY" | \
  jq '.[] | {name, status, bounce_rate: (.bounced / .sent * 100), reply_rate: (.replied / .sent * 100), daily_sends: .sent_today}'

Step 5: Dashboard Panels

Track: deliverability rate by campaign, bounce rate trend (alert if rising), sending account reputation scores (table), warmup progress per account, daily send volume vs limits, reply rate over time, and spam complaint rate. A rising bounce rate is the most urgent signal -- it can cascade into domain blacklisting.

Error Handling

Issue	Cause	Solution
Bounce rate >5%	Bad lead list quality	Verify emails before importing, use email verification API
Reputation dropping	Too many emails too fast	Reduce daily limit, extend warmup period
Campaign paused	Account hit daily send limit	Spread sends across more accounts
Opens not tracking	Tracking pixel blocked	Expected for privacy-focused recipients; use reply rate instead

Examples

Basic usage: Apply instantly observability to a standard project setup with default configuration options.

Advanced scenario: Customize instantly observability for production environments with multiple constraints and team-specific requirements.

Output

• Configuration files or code changes applied to the project
• Validation report confirming correct implementation
• Summary of changes made and their rationale

Resources

• Official monitoring documentation
• Community best practices and patterns
• Related skills in this plugin pack