Leads To Email
Create Workflow from CSV
POST /v1/leads-to-email
POST
/v1/leads-to-emailPOST
/v1/leads-to-email
Create a leads-to-email workflow from a CSV: enrich the leads, compose AI emails, and enroll them into a sequence
Content-Type: multipart/form-data with a file field (the CSV) plus the text fields below. JSON-valued fields (columnMapping, exportColumns, filters) must be sent as stringified JSON.
Authorization
x-api-key<token>
API key for Open API authentication
In: header
Request Body
multipart/form-dataRequiredfilefile
CSV file with the leads to enrich
Format:"binary"fileNamestring
Example: "q3-leads.csv"totalRecordsstring
Example: "250"revealTypestring
Example: "email"columnMappingstring
Example: "{\"First Name\":\"firstName\",\"Company Domain\":\"domain\"}"exportColumnsstring
Example: "[\"firstName\",\"lastName\",\"email\"]"webhookUrlstring
Example: "https://example.com/webhooks/leads-to-email"filtersstring
bodyTemplateIdstring
subjectTemplateIdstring
stepsstring
Example: "3"stepGapstring
Example: "3"stepContentstring
Stringified JSON array of caller-provided steps; skips AI compose
Example:"[{\"stepNumber\":1,\"subject\":\"Hi {{First Name}}\",\"content\":\"<p>Intro…</p>\"}]"Responses
201
Workflow created. Returns the workflow id to track progress.
{
"message": "Success",
"payload": {
"success": true,
"id": "64f1a2b3c4d5e6f7a8b9c0d1",
"status": "in_progress"
}
}