Submit a bulk job
start_bulk_jobRead-only
Submit up to 50 approved records for asynchronous email find, phone find, or enrichment. Get a job_id immediately, with costs reserved upfront. Poll the job or register a webhook for completion.
Instructions
Submit up to 50 records for asynchronous processing and get a job_id back. BILLABLE at the same per-record rate as the single-record tool — and the whole cost is RESERVED at submit time, so a submitted job keeps running (and keeps charging) even if you stop polling. Only submit a list the user has approved. Poll with get_bulk_job, or register a webhook to be told when it finishes.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | Enrich jobs only: cached (cheaper) or live. Default "database". | |
| items | Yes | Max 50. email_find/phone_find: {lead_id} | {linkedin_url} | {first_name,last_name,domain|company}. enrich_leads: {id} | {linkedin_url} | {email}. enrich_companies: {id} | {linkedin_url} | {domain} | {name}. | |
| job_type | Yes | What to do with the items. phone_find is by far the most expensive per record. | |
| timeout_ms | No | Request timeout in milliseconds. | |
| confirm_spend_usd | No | Explicit approval for an unusually large charge. Calls whose worst case exceeds $5 are refused unless this is set to at least the amount the tool reports. Only set it after the user has agreed to that number. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| job | No | ||
| cost | No | ||
| mode | No | ||
| dropped | No | ||
| job_type | No | ||
| next_step | No | ||
| submitted | No | ||
| test_mode | No | ||
| reservation_note | No | ||
| test_mode_notice | No | ||
| vocabulary_warnings | No | ||
| reserved_worst_case_usd | No | ||
| deprecated_params_ignored | No |