Outreach Magic API: Quick-Start Guide

Last Updated: July 26, 2024 | Version 1.0
Welcome to the official documentation for the Outreach Magic API. This guide provides everything you need to connect your tools to our powerful Outreach Magic Intelligence Layer.
Our API is designed to solve a critical problem: siloed outreach data. By integrating the API, you can check for existing contacts in real-time, enrich leads with their complete interaction history, and prevent sending duplicate messages.
Whether you're running campaigns in SmartLead or Instantly, building enrichment waterfalls in Clay, or managing workflows in n8n, these endpoints give you the unified data you need to engage leads more intelligently.
See it in action: To see a practical example of how our API can be used within Clay, check out this demo.

Authentication

All API requests must be authenticated with your personal API key. You can find your key in the "Settings" section of your Outreach Magic portal.

The API key must be included in the request headers.
Loading...

Endpoint: Lookup Lead

This endpoint is designed for precision. Use it to find a single, specific lead using their email or LinkedIn URL. It's ideal for enrichment and pre-send checks.
If multiple records for the same person exist across different profiles, this endpoint intelligently returns the single most recently active record.
- Method: POST
- URL: https://api.outreachmagic.io/v1/leads/lookup

Parameter Body

Loading...

Example Requests

Lookup using email:
{
  "profile_name": "synergy-corp-main",
  "email": "[email protected]"
Lookup using LinkedIn profile:
{
  "linkedin_url": "https://linkedin.com/in/alexjohnsondev"

Response

If a lead is found, you will receive a 200 OK response with a single JSON object. If no lead is found, you will receive a 200 OK with an empty object {}.
{
    "_id": "68759e292a9bf8bba446ef7f",
    "unified_lead_id": "[email protected]",
    "campaign_name": "Innovate Inc | Q1 Outreach",
    "company_domain": "innovateinc.com",
    "company_employee_count": 250,
    "company_industry": "Information Technology & Services",
    "company_linkedin_url": "https://linkedin.com/company/innovate-inc",
    "company_name": "Innovate Inc.",
    "company_updated_at": "2025-07-05T07:30:28.033Z",
    "event_history": [
        {
            "date": "2025-06-25T16:52:44.649Z",
            "event_type": "email_sent",
            "platform": "smartlead",
            "is_email_event": 1,
            "is_linkedin_event": 0,
            "subject": "Idea for Innovate Inc.",
            "body_text": "Hi Alex, I have an idea for how to improve your team's workflow...",
            "step": "1",
            "sender_id": "[email protected]",
            "sender_domain": "innovateinc.com",
            "sender_name": "Alex Jones",
            "sender_email_server": "google_business",
            "sender_email_reseller": "premium_inboxes"
        },
        {
            "date": "2025-06-25T18:10:15.112Z",
            "event_type": "email_reply",
            "platform": "smartlead",
            "is_email_event": 1,
            "is_linkedin_event": 0,
            "subject": "Re: Idea for Innovate Inc.",
            "body_text": "Hi Sarah, thanks for reaching out. Yes, I'm the correct contact...",
            "step": "1",
            "sender_id": "[email protected]",
            "sender_domain": "innovateinc.com",
            "sender_name": "Alex Jones",
            "sender_email_server": "google_business",
            "sender_email_reseller": "premium_inboxes"
        },
        {
            "date": "2025-06-28T11:05:00.000Z",
            "event_type": "linkedin_profile_visited",
            "platform": "heyreach",
            "is_email_event": 0,
            "is_linkedin_event": 1,
            "subject": null,
            "body_text": null,
            "step": null,
            "sender_id": "linkedin.com/in/sarahchen-sales",
            "sender_domain": null,
            "sender_name": "Sara Chen",
            "sender_email_server": null,
            "sender_email_reseller": null
        },
        {
            "date": "2025-07-01T09:30:00.000Z",
            "event_type": "linkedin_post_commented",
            "platform": "heyreach",
            "is_email_event": 0,
            "is_linkedin_event": 1,
            "subject": null,
            "body_text": "Great insights, Alex! This aligns perfectly with what we're seeing in the market.",
            "step": null,
            "sender_id": "linkedin.com/in/sarahchen-sales",
            "sender_domain": null,
            "sender_name": "Sara Chen",
            "sender_email_server": null,
            "sender_email_reseller": null
        }
    ],
    "first_touch_date": "2025-06-25T00:00:00.000Z",
    "import_name": "saas_founders_list_q1",
    "last_touch_date": "2025-07-01T00:00:00.000Z",
    "lead_status_name": "Engaged",
    "lead_status_sentiment": "positive",
    "person_email": "[email protected]",
    "person_first_name": "Alex",
    "person_job_title": "Head of Engineering",
    "person_last_name": "Johnson",
    "person_lead_type": "primary_contact",
    "person_linkedin_url": "https://linkedin.com/in/alexjohnsondev",
    "profile_name": "synergy-corp-main",
    "person_reporting_location": "Miami-Fort Lauderdale Area",
    "person_updated_at": "2025-07-05T03:40:52.217Z",
    "positive_touch_date": "2025-06-25T00:00:00.000Z",
    "total_email_events": 2,
    "total_emails_sent": 1,
    "total_events": 4,
    "total_linkedin_dms_sent": 0,
    "total_linkedin_events": 2

Endpoint: Lookup Lead

This endpoint is designed for discovery and analysis. Use it to find a list of leads that match a set of shared properties. All parameters are optional and are combined with AND logic (i.e., results must match all provided filters).
- Method: POST
- URL: https://api.outreachmagic.io/v1/leads/lookup

Parameter Body

Loading...

Example Requests

List all positive leads:
{
  "sentiment": "positive",
  "limit": 50
Find the primary contact for a specific company:
{
  "domain": "innovateinc.com",
  "lead_type": "primary_contact",
  "limit": 1

Response

The API will return a 200 OK with a JSON array of lead objects that match your criteria. If no leads are found, it will return an empty array [].
[
   {
      "_id":"68759e292a9bf8bba446ef7f",
      "unified_lead_id":"[email protected]",
      "campaign_name":"Innovate Inc | Q1 Outreach",
      "company_domain":"innovateinc.com",
      "company_employee_count":250,
      "company_industry":"Information Technology & Services",
      "company_linkedin_url":"https://linkedin.com/company/innovate-inc",
      "company_name":"Innovate Inc.",
      "company_updated_at":"2025-07-05T07:30:28.033Z",
      "event_history":[
         {
            "date":"2025-06-25T16:52:44.649Z",
            "event_type":"email_sent",
            "platform":"smartlead",
            "is_email_event":1,
            "is_linkedin_event":0,
            "subject":"Idea for Innovate Inc.",
            "body_text":"Hi Alex, I have an idea for how to improve your team's workflow...",
            "step":"1",
            "sender_id":"[email protected]",
            "sender_domain":"innovateinc.com",
            "sender_name":"Alex Jones",
            "sender_email_server":"google_business",
            "sender_email_reseller":"premium_inboxes"
         },
         {
            "date":"2025-06-25T18:10:15.112Z",
            "event_type":"email_reply",
            "platform":"smartlead",
            "is_email_event":1,
            "is_linkedin_event":0,
            "subject":"Re: Idea for Innovate Inc.",
            "body_text":"Hi Sarah, thanks for reaching out. Yes, I'm the correct contact...",
            "step":"1",
            "sender_id":"[email protected]",
            "sender_domain":"innovateinc.com",
            "sender_name":"Alex Jones",
            "sender_email_server":"google_business",
            "sender_email_reseller":"premium_inboxes"
         },
         {
            "date":"2025-06-28T11:05:00.000Z",
            "event_type":"linkedin_profile_visited",
            "platform":"heyreach",
            "is_email_event":0,
            "is_linkedin_event":1,
            "subject":null,
            "body_text":null,
            "step":null,
            "sender_id":"linkedin.com/in/sarahchen-sales",
            "sender_domain":null,
            "sender_name":"Sara Chen",
            "sender_email_server":null,
            "sender_email_reseller":null
         },
         {
            "date":"2025-07-01T09:30:00.000Z",
            "event_type":"linkedin_post_commented",
            "platform":"heyreach",
            "is_email_event":0,
            "is_linkedin_event":1,
            "subject":null,
            "body_text":"Great insights, Alex! This aligns perfectly with what we're seeing in the market.",
            "step":null,
            "sender_id":"linkedin.com/in/sarahchen-sales",
            "sender_domain":null,
            "sender_name":"Sara Chen",
            "sender_email_server":null,
            "sender_email_reseller":null
         }
      ],
      "first_touch_date":"2025-06-25T00:00:00.000Z",
      "import_name":"saas_founders_list_q1",
      "last_touch_date":"2025-07-01T00:00:00.000Z",
      "lead_status_name":"Engaged",
      "lead_status_sentiment":"positive",
      "person_email":"[email protected]",
      "person_first_name":"Alex",
      "person_job_title":"Head of Engineering",
      "person_last_name":"Johnson",
      "person_lead_type":"primary_contact",
      "person_linkedin_url":"https://linkedin.com/in/alexjohnsondev",
      "profile_name":"synergy-corp-main",
      "person_reporting_location":"Miami-Fort Lauderdale Area",
      "person_updated_at":"2025-07-05T03:40:52.217Z",
      "positive_touch_date":"2025-06-25T00:00:00.000Z",
      "total_email_events":2,
      "total_emails_sent":1,
      "total_events":4,
      "total_linkedin_dms_sent":0,
      "total_linkedin_events":2

Next Steps & Support

You now have the tools to build powerful, data-aware outreach sequences. By integrating the Outreach Magic API with tools like n8n, SmartLead, and your own custom scripts, you can create sophisticated enrichment waterfalls, ensure data hygiene across platforms, and guarantee you always have the full context before engaging a lead.
Have questions, or is there an integration or feature you'd like to see? We're constantly expanding our capabilities and would love to hear from you. Please reach out to our team and we'll be happy to help.