Superkabe LogoSuperkabe

Smartlead Integration Guide

Step-by-step guide to connect Smartlead with Superkabe for real-time bounce monitoring and mailbox protection

What You'll Accomplish

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

  1. ✅ Send real-time bounce and delivery events to Superkabe
  2. ✅ Trigger automated mailbox pausing at 5 bounces / 100 sends
  3. ✅ Enable domain-level protection when 50% of mailboxes are unhealthy
  4. ✅ Provide visibility into execution blocking reasons

Prerequisites

  • ✓ Active Superkabe account (Sign up here)
  • ✓ Smartlead account with active campaigns
  • ✓ Smartlead API key (found in Smartlead Settings)
  • ✓ Your mailboxes should be imported into Superkabe first
  • ✓ Admin access to Smartlead webhook settings

Step 1: Add Smartlead API Key to Superkabe

Superkabe needs your Smartlead API key to sync campaign and mailbox data.

Get Your Smartlead API Key

  1. 1. Log in to Smartlead
  2. 2. Navigate to Settings → API
  3. 3. Copy your API key (format: sl_live_xxxxxxxxxxxx)

Add API Key to Superkabe

  1. 1. In Superkabe, go to Settings → Integrations
  2. 2. Find the Smartlead section
  3. 3. Paste your API key in the API Key field
  4. 4. Click Save
  5. 5. Superkabe will validate the key and sync your campaigns

✓ Expected Result

After saving, you should see your Smartlead campaigns appear in the Superkabe dashboard under Campaigns.

Step 2: Get Your Webhook URL and Organization ID

You'll need these to configure webhooks in Smartlead.

Webhook URL:

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

Your Organization ID:

Found in Superkabe → Settings → API Keys

YOUR_ORGANIZATION_ID

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

Step 3: Configure Webhooks in Smartlead

Set up Smartlead to send bounce and delivery events to Superkabe in real-time.

  1. 1. Navigate to Smartlead Webhook Settings

    Smartlead Dashboard → Settings → Webhooks → Add New Webhook

  2. 2. Enter Webhook Details

    Webhook Name:

    Superkabe Monitoring

    Webhook URL:

    https://api.superkabe.com/api/monitor/smartlead-webhook
  3. 3. Add Custom Header

    Click Add Header and input:

    Header Name:

    x-organization-id

    Header Value:

    YOUR_ORG_ID

    (UUID format)

  4. 4. Select Events to Monitor

    Check the following event types:

    • ☑email_sent— Tracks send volume
    • ☑email_bounce— Critical for monitoring
    • ☑hard_bounce— Hard failures
    • ☑soft_bounce— Logged, not counted
    • ☑delivery_failure— Delivery issues
  5. 5. Save and Test

    Click Save Webhook. Smartlead may send a test event to verify the endpoint.

Step 4: (Optional) Configure Webhook Secret

For production environments, enable webhook signature validation for added security.

  1. 1. In Smartlead, generate a webhook secret (if supported)
  2. 2. In Superkabe, go to Settings → Integrations → Smartlead
  3. 3. Add the secret in the Webhook Secret field
  4. 4. Superkabe will validate incoming webhook signatures using HMAC-SHA256

💡 Development vs Production

In development, Superkabe allows webhooks without signature validation. For production, we strongly recommend configuring a webhook secret.

Step 5: Verify Webhook Integration

Test that Smartlead events are flowing correctly into Superkabe.

Method 1: Send a Test Email

  1. 1. From one of your Smartlead campaigns, send a test email
  2. 2. Wait 1-2 minutes for the email_sent webhook
  3. 3. In Superkabe, check Dashboard → Mailboxes
  4. 4. Verify the send count incremented for the mailbox

Method 2: Check Audit Logs

  1. 1. Navigate to Superkabe → Audit Log
  2. 2. Look for recent events like:
  • • EMAIL_SENT event from Smartlead
  • • MONITORING action for mailbox
  • • Mailbox ID and campaign ID should match

✓ What Success Looks Like

When webhooks are working correctly, you'll see:

  • ✓ Real-time send counts updating in Superkabe dashboard
  • ✓ Bounce events logged in audit trail
  • ✓ Mailbox health scores reflecting actual sending patterns
  • ✓ Warnings appearing when thresholds approach (3 bounces / 60 sends)

Step 6: Configure System Mode

Choose how aggressively Superkabe should protect your infrastructure.

OBSERVE

Logs all events without blocking execution.

Use for: First week of integration to establish baseline

SUGGEST

Provides recommendations without automated actions.

Use for: Review mode before enabling enforcement

ENFORCE

Fully automated pausing and protection.

Use for: Production protection (recommended)

To change system mode:

  1. 1. Navigate to Settings → System Mode
  2. 2. Select your preferred mode
  3. 3. Click Save Changes

Troubleshooting

IssueSolution
Webhooks return 401Verify x-organization-id header is correct
Events not appearingCheck webhook URL ends with /smartlead-webhook
Signature validation failsEnsure webhook secret matches in both Smartlead and Superkabe
Mailbox not found errorsSync mailboxes from Smartlead via Settings → Sync Data
Delayed event processingNormal latency is 30-60 seconds; check Smartlead webhook logs

Understanding What Superkabe Monitors

Mailbox-Level Monitoring:

  • • Warning: 3 bounces within last 60 sends
  • • Pause: 5 bounces within last 100 sends
  • • Uses rolling window (not hard resets)

Domain-Level Monitoring:

  • • Warning: 30% of mailboxes unhealthy
  • • Pause: 50% of mailboxes unhealthy
  • • Ratio-based for scalability

Lead-Level Protection:

  • • Blocked if assigned mailbox/domain is paused
  • • Execution gate checks before each send
  • • State transitions logged in audit trail

🎉 Integration Complete!

Your Smartlead campaigns are now protected by Superkabe. Next steps: