Bulk email find - Autotouch AI

This page documents the canonical HTTP contract for this endpoint.

The route also accepts a top-level ID array. Selection is restricted to the authenticated organization. Leads already containing a usable email, a prior not_found result (unless skip_previously_attempted is false), or lacking both full name and LinkedIn URL are skipped. This illustrates the queued case; queued responses also include job_id, operation_run_id, operationRunId, processable_ids, and optionally process_limit. Poll a queued operation with GET /api/operation-runs/{operation_run_id} (requires jobs:read). When no leads qualify it returns success and skipped details without job IDs.

Body parameters

lead_ids · optional
array<string>
Explicit lead IDs. Provide either lead_ids or selection.
selection · optional
object
BulkSelectionModel using ids or descriptor mode.
scope · optional
string
Optional org or user selection scope.
source_table_id · optional
string
Optional Research Table context.
source_table_scope · optional
string
Optional company or lead Research Table scope.
process_limit · optional
integer
Max number of leads to process (1-10000).
skip_previously_attempted · optional
boolean
Skip leads with prior not_found result. Defaults to true.

Name	Type	Description
lead_ids	array<string>	Explicit lead IDs. Provide either lead_ids or selection.
selection	object	BulkSelectionModel using ids or descriptor mode.
scope	string	Optional org or user selection scope.
source_table_id	string	Optional Research Table context.
source_table_scope	string	Optional company or lead Research Table scope.
process_limit	integer	Max number of leads to process (1-10000).
skip_previously_attempted	boolean	Skip leads with prior not_found result. Defaults to true.

Errors

Status	Meaning
400	Invalid payload or some leads not found.
401	Invalid API key or missing auth.
403	Missing leads:read or leads:write scope.
404	No leads found for selection.
503	Failed to queue email finding task.

Example

bash

curl -X POST "https://app.autotouch.ai/api/leads/bulk-email-find" \
    -H "Authorization: Bearer stk_your_key_id.your_secret" \
    -H "Content-Type: application/json" \
    -d '{"lead_ids":["67c4b113b4dd8f2d4999f0f1"]}'

Request body

json

{
    "lead_ids": ["67c4b113b4dd8f2d4999f0f1", "67c4b113b4dd8f2d4999f0f2"],
    "process_limit": 500
  }

Response example

json

{
    "success": true,
    "message": "Email finding started for 2 leads",
    "task_id": "abc123def456",
    "matched_count": 2,
    "processable_count": 2,
    "skipped_count": 0,
    "limit_reached": false,
    "skipped_details": []
  }