Lead Lists

Managing Leads

View, add, remove, and inspect individual leads within your lists.

Viewing a Lead

Click any lead in the dashboard to see their full profile:

Contact info (email, name, company, custom fields)
Validation status and results
Full delivery history (every email sent, opens, clicks, replies)
Click log (which links they clicked and when)
Unsubscribe status

Adding a Single Lead

bash

curl -X POST http://YOUR_SERVER/v1/outreach/lists/LIST_ID/leads \
  -H "Content-Type: application/json" \
  -H "Cookie: auth_token=YOUR_SESSION" \
  -d '{
    "email": "new@example.com",
    "first_name": "New",
    "last_name": "Lead",
    "company": "Acme Corp",
    "extra_data": {"title": "CEO"}
  }'

Deleting a Lead

bash

curl -X DELETE http://YOUR_SERVER/v1/outreach/leads/LEAD_ID \
  -H "Cookie: auth_token=YOUR_SESSION"

Unsubscribed Leads

When a lead unsubscribes (via the unsubscribe link in emails), they are marked with unsubscribed: true. Unsubscribed leads are automatically excluded from all future campaign sends across all lists.

Lead Properties

Field	Description
`email`	Email address (required)
`first_name`	First name (for personalization)
`last_name`	Last name
`company`	Company name
`extra_data`	JSON object with custom fields (title, linkedin, etc.)
`valid`	Whether the email is valid (updated by validation)
`validation_status`	pending, valid, invalid, catchall, disposable, role
`unsubscribed`	Whether the lead has opted out