FoxReach icon

FoxReach

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

Actions43

Lead → Bulk Import

AI-generated

Summary

Import multiple lead records in a single API call, optionally restoring soft-deleted leads matching the provided email addresses.

Inputs

  • Leads JSON (required) — A JSON array of lead objects to import, each supporting fields like email, firstName, lastName, company, title, phone, linkedinUrl, website, notes, status, customFields, and tags. Maximum 1000 leads per call.
  • Restore Soft-Deleted Leads — Boolean to determine if leads that were soft-deleted but match emails in the import list should be restored (counted as restored) or considered duplicates instead.

Output shape

A single JSON object containing counts of created, restored, duplicate, and error leads instead of detailed per-lead data.

The operation accepts up to 1000 leads in the input array. It returns counts rather than detailed information per lead. Soft-deleted leads matching by email are restored automatically if the 'Restore Soft-Deleted Leads' option is enabled (default true). If disabled, such leads count as duplicates.

Examples

Example 1: Bulk import multiple leads with restoring soft-deleted duplicates

Set 'Leads JSON' to the array of lead objects and 'Restore Soft-Deleted Leads' to true (default).

Example 2: Bulk import leads without restoring soft-deleted duplicates

Set 'Leads JSON' to the array of lead objects and 'Restore Soft-Deleted Leads' to false to treat soft-deleted matching leads as duplicates.

Links

Discussion