Skip to main content
POST
/
v1
/
tools
/
enrich
/
email
Find Email
curl --request POST \
  --url https://api.example.com/v1/tools/enrich/email \
  --header 'Content-Type: application/json' \
  --data '
{
  "full_name": "<string>",
  "first_name": "<string>",
  "last_name": "<string>",
  "company_domain": "<string>"
}
'

​
Overview

Find the email address for a person given their name and company domain. Uses multiple data providers to find and verify email addresses.

​
Request Body

​
full_name
string
Full name of the person (alternative to first_name + last_name)
​
first_name
string
First name (required if full_name not provided)
​
last_name
string
Last name (required if full_name not provided)
​
company_domain
string
required
Company domain (e.g., “microsoft.com”)

​
Response (202 - Processing)

{
  "request_id": "req_abc123",
  "status": "processing",
  "tool": "enrich_email",
  "message": "Email enrichment job queued successfully"
}

​
Job Result

{
  "status": "completed",
  "result": {
    "email": "[email protected]",
    "found": true,
    "confidence": "high",
    "source": "enrichment"
  }
}
If email not found: 
{
  "status": "completed",
  "result": {
    "email": null,
    "found": false,
    "source": "enrichment"
  }
}

​
SDK Usage

// Using full name
const result = await agent.findEmail({
  full_name: 'Satya Nadella',
  company_domain: 'microsoft.com'
});

// Using first + last name
const result = await agent.findEmail({
  first_name: 'Satya',
  last_name: 'Nadella',
  company_domain: 'microsoft.com'
});

if (result.found) {
  console.log(`Email: ${result.email}`);
} else {
  console.log('Email not found');
}

​
Example: Research and Outreach Flow

// 1. Search for decision makers
const people = await agent.peopleSearch({
  job_titles: ['CTO', 'VP Engineering'],
  companies: ['Stripe'],
  limit: 5
});

// 2. Find their emails
for (const person of people.results) {
  const email = await agent.findEmail({
    full_name: person.full_name,
    company_domain: person.company_domain
  });

  if (email.found) {
    // 3. Send outreach email
    await agent.email({
      to: email.email,
      subject: `Quick question for ${person.first_name}`,
      body: `Hi ${person.first_name},...`
    });
  }
}