FoxReach icon

FoxReach

Manage leads and campaigns in FoxReach cold email outreach platform. See https://docs.foxreach.io/ for API documentation.

Lead → Create

AI-generated

Summary

Create a new lead in the FoxReach workspace by providing a unique email address and optionally specifying additional lead details such as first name, last name, company, job title, phone, LinkedIn URL, website, notes, status, tags, and custom fields.

Inputs

  • Email (required) — Email address of the lead. Must be unique within the workspace.
  • First Name — First name of the lead.
  • Last Name — Last name of the lead.
  • Company — Company name associated with the lead.
  • Job Title — Job title of the lead.
  • Phone — Phone number of the lead.
  • LinkedIn URL — LinkedIn profile URL of the lead.
  • Website — Website associated with the lead.
  • Notes — Additional notes about the lead.
  • Status — Current status of the lead; options include Active, Bounced, Unsubscribed, and Replied. Defaults to Active.
  • Tags — List of tag names to attach to the lead; tags are either found or created within the workspace.
  • Custom Fields (JSON) — JSON object specifying custom key-value fields defined by the workspace, e.g., {"industry": "saas", "headcount": 250}.

Output shape

a single lead record object

Returns the newly created lead data as a JSON object. The lead's unique ID and all provided fields are included in the response.

Examples

Example 1: Create a lead with minimal information

Set only the required Email parameter with a unique email address.

Example 2: Create a lead with full details

Provide Email, First Name, Last Name, Company, Title, Phone, LinkedIn URL, Website, Notes, Status, Tags, and Custom Fields JSON.

Links

Discussion