Bulk mobile find - Autotouch AI

This page documents the canonical HTTP contract for this endpoint.

The route also accepts a top-level ID array. Existing mobile numbers and prior not_found results (unless skip_previously_attempted is false) are skipped. Remaining Leads need an email, LinkedIn URL, or first and last name plus company name/domain. This illustrates the queued case; queued responses include job_id, operation_run_id, operationRunId, processable_ids, limit_reached and 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
Optional maximum to process; integer 1 through 10,000.
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	Optional maximum to process; integer 1 through 10,000.
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 mobile finding task.

Example

bash

curl -X POST "https://app.autotouch.ai/api/leads/bulk-mobile-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"]
  }

Response example

json

{
    "success": true,
    "message": "Mobile finding started for 2 leads",
    "task_id": "abc123def456",
    "matched_count": 2,
    "processing": 2,
    "skipped": 0,
    "skipped_details": []
  }