Superkabe LogoSuperkabe

Instantly Integration Guide

Connect your Instantly account to sync campaigns, track per-mailbox engagement, and enable real-time deliverability protection inside Superkabe.

What You'll Accomplish

By the end of this guide, your Instantly campaigns will:

  1. ✅ Sync campaigns and mailboxes into Superkabe automatically every 20 minutes
  2. ✅ Send real-time engagement events (opens, clicks, replies, bounces) via webhooks
  3. ✅ Trigger automated mailbox pausing when bounce thresholds are breached
  4. ✅ Enable domain-level protection when multiple mailboxes go unhealthy
  5. ✅ Provide per-mailbox stats visible on the Superkabe dashboard

Prerequisites

  • ✓ Active Superkabe account (Sign up here)
  • ✓ Instantly account on the Growth plan or above (required for V2 API access)
  • ✓ Admin access to Instantly Settings to generate API keys and configure webhooks
  • ✓ Your Organization ID from Superkabe Settings (UUID format)

Step 1: Generate Your Instantly V2 API Key

Superkabe uses the Instantly V2 API to sync your campaigns, mailboxes, and sending statistics. The V2 API is required — V1 keys will not work.

⚠️ Plan Requirement

Instantly V2 API access requires the Growth plan or above. If you are on the Sending plan, you will need to upgrade before proceeding.

Get Your V2 API Key

  1. 1. Log in to your Instantly account
  2. 2. Navigate to Settings → API Keys
  3. 3. Click Create API Key and give it a name (e.g., Superkabe)
  4. 4. Select V2 as the API version
  5. 5. Copy the generated key — it will look like:inst_v2_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
  6. 6. Store it securely — it won't be shown again after leaving the page

Step 2: Add Your API Key to Superkabe

Once you have your V2 API key, add it to Superkabe so campaigns and mailboxes can be synced.

  1. 1. In Superkabe, go to Settings → Integrations
  2. 2. Select the Instantly tab
  3. 3. Paste your V2 API key into the Instantly API V2 Key field
  4. 4. Click Save Configuration
  5. 5. Superkabe will validate the key and begin syncing your campaigns and mailboxes

✓ Expected Result

After saving, your Instantly campaigns and sending accounts will appear in the Superkabe dashboard under Campaigns and Mailboxes within a few minutes.

Step 3: Get Your Webhook URL and Organization ID

You'll need two pieces of information to configure webhooks in Instantly.

Webhook URL:

Found in Superkabe → Settings → Instantly → Webhook Endpoint (copy button provided)

https://api.superkabe.com/api/monitor/instantly-webhook

Your Organization ID:

Found in Superkabe → Settings → API Keys → Organization ID

YOUR_ORGANIZATION_ID

UUID format (e.g., 123e4567-e89b-12d3-a456-426614174000)

Step 4: Configure Webhooks in Instantly

Set up Instantly to send real-time events to Superkabe so per-mailbox stats and health signals are always up to date.

  1. 1. Open Instantly Webhook Settings

    Instantly Dashboard → Settings → Integrations → Webhooks → Add Webhook

  2. 2. Enter the Webhook URL

    Paste this URL into the webhook URL field:

    https://api.superkabe.com/api/monitor/instantly-webhook
  3. 3. Add the Organization ID Header

    Click Add Header and enter the following:

    Header Name:

    x-organization-id

    Header Value:

    YOUR_ORG_ID

    (your UUID from Superkabe Settings)

  4. 4. Select Events to Monitor

    Enable all of the following event types:

    • ☑email_sent— Tracks send volume per mailbox
    • ☑email_opened— Open rate tracking
    • ☑email_clicked— Click rate tracking
    • ☑email_replied— Reply rate tracking
    • ☑email_bounced— Critical for health monitoring
    • ☑email_unsubscribed— Unsubscribe tracking
  5. 5. Save the Webhook

    Click Save. Instantly may send a test ping to verify your endpoint is reachable.

Step 5: Auto-Sync and Manual Sync

Superkabe syncs your Instantly data on two schedules:

⚡

24/7 Auto-Sync

LIVE

Superkabe automatically syncs your Instantly campaigns, mailboxes, and stats every 20 minutes. No action required — it runs continuously in the background.

🔄

Manual Sync

For immediate updates after making changes in Instantly (e.g., pausing a campaign, adding mailboxes), use the Trigger Manual Sync button in Settings → Instantly.

Step 6: Verify the Integration

Confirm that campaigns and events are flowing correctly into Superkabe.

Check Campaign Sync

  1. 1. In Superkabe, navigate to Campaigns
  2. 2. Your Instantly campaigns should be listed with their current status
  3. 3. Click a campaign to see its associated mailboxes and per-mailbox stats

Check Webhook Events

  1. 1. Send a test email from one of your Instantly campaigns
  2. 2. Wait 1–2 minutes for the email_sent webhook event
  3. 3. In Superkabe, go to Audit Log and look for a recent Instantly event entry
  4. 4. Check Mailboxes — the sending mailbox's Sent counter should have incremented

✓ What Success Looks Like

  • ✓ Instantly campaigns visible in Superkabe Campaigns page
  • ✓ Per-mailbox stats (Sent, Opens, Clicks, Replies, Bounces) updating in real time
  • ✓ Bounce events appearing in the Audit Log
  • ✓ Mailbox health scores reflecting actual engagement patterns
  • ✓ Warnings triggered when mailbox bounce thresholds approach

What Superkabe Monitors From Instantly

Per-Mailbox Engagement Metrics:

  • • Sent — total emails dispatched from each mailbox
  • • Opens — unique open count per mailbox
  • • Clicks — link clicks tracked per mailbox
  • • Replies — response rate per mailbox
  • • Bounces — hard bounce count (triggers health logic)
  • • Unsubscribes — opt-out signals per mailbox

Mailbox Health Thresholds:

  • • Warning: 3 bounces within the last 60 sends
  • • Pause: 5 bounces within the last 100 sends
  • • Uses a rolling window — not hard resets on each sync

Domain-Level Protection:

  • • Warning: 30% of domain mailboxes are unhealthy
  • • Pause: 50% of domain mailboxes are unhealthy
  • • Ratio-based so it scales with your infrastructure size

Campaign-Level Visibility:

  • • Campaign status synced (active, paused, completed)
  • • Mailbox assignment per campaign tracked
  • • Execution blocking reasons logged in the audit trail

Troubleshooting

IssueSolution
API key rejected on saveEnsure you're using a V2 key, not a V1 key. Requires Growth plan or above.
Campaigns not appearingWait up to 20 minutes for the next auto-sync, or use Trigger Manual Sync in Settings.
Webhooks returning 401Verify the x-organization-id header value matches your Superkabe Organization ID exactly.
Per-mailbox stats not updatingConfirm all 6 webhook event types are selected in Instantly and the webhook URL is correct.
Webhook events not appearing in Audit LogCheck Instantly's webhook delivery log for failed attempts. Normal processing latency is 15–60 seconds.
Mailboxes missing from campaign viewTrigger a manual sync. Newly added sending accounts may take up to one sync cycle to appear.

🎉 Integration Complete!

Your Instantly campaigns are now connected to Superkabe. Here's what to explore next: