Bulk enrichment
Trigger
Use when the user has a CSV/JSON/JSONL file, many rows, or asks to queue bulk enrichment.
Workflow
- Free
check_credit_balancethenpreview_costwhen product/volume is known. - Confirm with the user before write tools (hook will also ask).
- Prefer
process_attached_csv/create_bulk_upload_sessionfor the upload widget, orsubmit_detected_bulk_jobwhen mapping is ready. - After submit:
get_bulk_job_statusonce, then wait ≥45 seconds between polls. - On completion:
get_bulk_job_rows/get_bulk_job_errorsas needed. - Never loop single-contact tools across a whole file.
Output
- Job id / status
- Credits context
- Row success/error summary
- Next action (retry failures, export)