Workflows
Run workflow API
Run a single contact through the latest published version of a workflow via POST, returning an execution ID you can poll for status and results.
POST
cURL
reference_id is the contact’s identity within the workflow version: repeating it returns 409 duplicate_run with the existing execution_id, which makes the call safely retryable. When omitted, an identity is derived from the row’s content.Fields declared by the start node can be passed flat at the top level — exactly like CSV columns — or nested under
custom_fields. On a name collision the flat key wins. Undeclared keys are rejected with 422 unknown_field.Authorizations
Body
application/json
One contact. Fields declared by the published version's start node may be passed flat at the top level (like CSV columns) or nested under custom_fields; a flat key wins on collision.
Response
Execution created
Id of the created execution. Poll it with the Get Execution API.