Quick Start

Add your first lead to a campaign in 5 minutes

Prerequisites

Before you begin, make sure you have:

  • A Magnetite account (sign up at magnetite.ai)
  • An active campaign (created via dashboard or our team)
  • An API key from your settings

Step 1: Get Your API Credentials

  1. Log in to your Magnetite dashboard
  2. Go to Settings → API Keys
  3. Click Create API Key
  4. Copy your API key (it's only shown once)

Step 2: Get Your Campaign ID

  1. Go to your campaign in the dashboard
  2. Find the API Integration section
  3. Copy your campaign ID

The campaign ID looks like: jd7z3k4n5r8m2p1q6w9

Step 3: Add Your First Lead

Here's how to add a lead to your campaign using different languages:

curl -X POST https://magnetite.ai/api/campaigns/YOUR_CAMPAIGN_ID/leads \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "companyName": "Acme Corp",
    "contactName": "John Smith",
    "email": "john@acme.com",
    "title": "VP of Sales"
  }'

Step 4: Check the Response

A successful response will look like this:

{
  "success": true,
  "prospectId": "abc123def456",
  "status": "queued",
  "message": "Lead added to campaign and queued for outreach"
}

prospectId: Unique identifier for this lead in your campaign

status: The lead is now queued for research and outreach

What Happens Next?

Once you add a lead, Magnetite automatically:

  1. Scores the lead against your campaign's Ideal Customer Profile (ICP)
  2. Researches the company and contact using AI
  3. Generates personalized email content
  4. Adds them to your outreach sequence
  5. Sends emails according to your campaign schedule

You can track leads and their status in your campaign dashboard.

Get Notified of Meetings

Set up a webhook to receive notifications when a lead books a meeting:

{
  "event": "meeting_booked",
  "campaignId": "YOUR_CAMPAIGN_ID",
  "prospect": {
    "companyName": "Acme Corp",
    "contactName": "John Smith",
    "email": "john@acme.com"
  },
  "meeting": {
    "scheduledAt": "2026-01-20T14:00:00Z",
    "duration": 30
  }
}

Learn more about webhooks →

What's Next?

API Reference

Learn about all available fields and enrichment options

View Full API Docs →

Set Up Integrations

Connect with Zapier or n8n for no-code automation

Browse Integrations →