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