Skip to main content
POST
https://api.foxreach.io
/
api
/
v1
/
leads
curl -X POST "https://api.foxreach.io/api/v1/leads" \
  -H "X-API-Key: otr_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "firstName": "Jane",
    "lastName": "Smith",
    "company": "TechCorp",
    "title": "CTO",
    "customFields": { "industry": "FinTech", "employees": "50-100" }
  }'

{
  "data": {
    "id": "cld_xyz789",
    "email": "[email protected]",
    "firstName": "Jane",
    "lastName": "Smith",
    "company": "TechCorp",
    "title": "CTO",
    "phone": null,
    "linkedinUrl": null,
    "website": null,
    "customFields": { "industry": "FinTech", "employees": "50-100" },
    "notes": null,
    "source": "api",
    "status": "active",
    "lastContactedAt": null,
    "createdAt": "2025-01-15T10:30:00",
    "updatedAt": "2025-01-15T10:30:00"
  }
}

​
Request Body

​
email
string
required
Email address of the lead. Must be unique within the workspace.
​
firstName
string
First name.
​
lastName
string
Last name.
​
company
string
Company name.
​
title
string
Job title.
​
phone
string
Phone number.
​
linkedinUrl
string
LinkedIn profile URL.
​
website
string
Website URL.
​
customFields
object
Custom key-value fields for additional data.
​
notes
string
Freeform notes about the lead.
​
source
string
default:"api"
Source tracking (e.g., api, csv_import, manual).
​
status
string
default:"active"
Initial status: active, bounced, unsubscribed, or replied.

​
Response

Returns the created lead object with a 201 status code. 
curl -X POST "https://api.foxreach.io/api/v1/leads" \
  -H "X-API-Key: otr_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "firstName": "Jane",
    "lastName": "Smith",
    "company": "TechCorp",
    "title": "CTO",
    "customFields": { "industry": "FinTech", "employees": "50-100" }
  }'

{
  "data": {
    "id": "cld_xyz789",
    "email": "[email protected]",
    "firstName": "Jane",
    "lastName": "Smith",
    "company": "TechCorp",
    "title": "CTO",
    "phone": null,
    "linkedinUrl": null,
    "website": null,
    "customFields": { "industry": "FinTech", "employees": "50-100" },
    "notes": null,
    "source": "api",
    "status": "active",
    "lastContactedAt": null,
    "createdAt": "2025-01-15T10:30:00",
    "updatedAt": "2025-01-15T10:30:00"
  }
}

​
Errors

StatusDescription
409A lead with this email already exists in the workspace
422Invalid request body (e.g., invalid email format)