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
- Log in to your Magnetite dashboard
- Go to Settings → API Keys
- Click Create API Key
- Copy your API key (it's only shown once)
Keep your API key secure and never commit it to version control. Use environment variables instead.
Step 2: Get Your Campaign ID
- Go to your campaign in the dashboard
- Find the API Integration section
- 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:
- Scores the lead against your campaign's Ideal Customer Profile (ICP)
- Researches the company and contact using AI
- Generates personalized email content
- Adds them to your outreach sequence
- 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
}
}