curl -X POST "https://api.encrata.com/api/workflows/6f1c2e94-2b6a-4a1e-9b3a-6c9f0f2a1d77/run" \
-H "Authorization: Bearer YOUR_DASHBOARD_TOKEN" \
-H "Idempotency-Key: run-20260601-001" \
-H "Content-Type: application/json" \
-d '{ "email": "jane@company.com" }'
import requests
workflow_id = "6f1c2e94-2b6a-4a1e-9b3a-6c9f0f2a1d77"
resp = requests.post(
f"https://api.encrata.com/api/workflows/{workflow_id}/run",
headers={
"Authorization": "Bearer YOUR_DASHBOARD_TOKEN",
"Idempotency-Key": "run-20260601-001",
},
json={"email": "jane@company.com"},
)
print(resp.json())
{
"id": "d4e5f6a1-7b8c-4d9e-8f10-1a2b3c4d5e6f",
"workflow_id": "6f1c2e94-2b6a-4a1e-9b3a-6c9f0f2a1d77",
"status": "pending",
"trigger_data": { "email": "jane@company.com" },
"credits_used": 0,
"started_at": "2026-06-01T10:00:00Z"
}
Workflows
Run Workflow
Trigger a manual workflow execution. Dashboard-only.
POST
/
api
/
workflows
/
{id}
/
run
curl -X POST "https://api.encrata.com/api/workflows/6f1c2e94-2b6a-4a1e-9b3a-6c9f0f2a1d77/run" \
-H "Authorization: Bearer YOUR_DASHBOARD_TOKEN" \
-H "Idempotency-Key: run-20260601-001" \
-H "Content-Type: application/json" \
-d '{ "email": "jane@company.com" }'
import requests
workflow_id = "6f1c2e94-2b6a-4a1e-9b3a-6c9f0f2a1d77"
resp = requests.post(
f"https://api.encrata.com/api/workflows/{workflow_id}/run",
headers={
"Authorization": "Bearer YOUR_DASHBOARD_TOKEN",
"Idempotency-Key": "run-20260601-001",
},
json={"email": "jane@company.com"},
)
print(resp.json())
{
"id": "d4e5f6a1-7b8c-4d9e-8f10-1a2b3c4d5e6f",
"workflow_id": "6f1c2e94-2b6a-4a1e-9b3a-6c9f0f2a1d77",
"status": "pending",
"trigger_data": { "email": "jane@company.com" },
"credits_used": 0,
"started_at": "2026-06-01T10:00:00Z"
}
This endpoint is not available on the developer API.
POST /api/workflows/{id}/run is dashboard-only. Calling it on
https://developer.encrata.com with an API key returns 404 with the body
"That endpoint is not available on the developer API."To trigger a workflow programmatically, give it a webhook trigger and post
to its ingest URL instead. See the
Workflows guide.This page documents the request shape for reference only.Authentication
Requires a dashboard session (JWT) onhttps://api.encrata.com.
Request
string
required
The workflow’s UUID.
Post your trigger fields at the top level of the body. The entire request
body becomes the run’s
trigger_data. Wrapping it in {"input": {...}} means
{{trigger.email}} resolves to nothing and your lookup steps run empty.object
Any JSON object. Each top-level key is readable in step config as
{{trigger.<key>}}.string
Optional. Prevents duplicate runs if the same key is sent again within 24 hours.
Example request
curl -X POST "https://api.encrata.com/api/workflows/6f1c2e94-2b6a-4a1e-9b3a-6c9f0f2a1d77/run" \
-H "Authorization: Bearer YOUR_DASHBOARD_TOKEN" \
-H "Idempotency-Key: run-20260601-001" \
-H "Content-Type: application/json" \
-d '{ "email": "jane@company.com" }'
import requests
workflow_id = "6f1c2e94-2b6a-4a1e-9b3a-6c9f0f2a1d77"
resp = requests.post(
f"https://api.encrata.com/api/workflows/{workflow_id}/run",
headers={
"Authorization": "Bearer YOUR_DASHBOARD_TOKEN",
"Idempotency-Key": "run-20260601-001",
},
json={"email": "jane@company.com"},
)
print(resp.json())
Response
Returns the created run. Its initial status ispending - the executor has
not picked it up yet. Poll
Get workflow run for progress.
curl -X POST "https://api.encrata.com/api/workflows/6f1c2e94-2b6a-4a1e-9b3a-6c9f0f2a1d77/run" \
-H "Authorization: Bearer YOUR_DASHBOARD_TOKEN" \
-H "Idempotency-Key: run-20260601-001" \
-H "Content-Type: application/json" \
-d '{ "email": "jane@company.com" }'
import requests
workflow_id = "6f1c2e94-2b6a-4a1e-9b3a-6c9f0f2a1d77"
resp = requests.post(
f"https://api.encrata.com/api/workflows/{workflow_id}/run",
headers={
"Authorization": "Bearer YOUR_DASHBOARD_TOKEN",
"Idempotency-Key": "run-20260601-001",
},
json={"email": "jane@company.com"},
)
print(resp.json())
{
"id": "d4e5f6a1-7b8c-4d9e-8f10-1a2b3c4d5e6f",
"workflow_id": "6f1c2e94-2b6a-4a1e-9b3a-6c9f0f2a1d77",
"status": "pending",
"trigger_data": { "email": "jane@company.com" },
"credits_used": 0,
"started_at": "2026-06-01T10:00:00Z"
}
There is no
input field on a run. The body you posted is echoed back as
trigger_data.Rate limits
Workflow runs are limited to 60 per minute per user. Exceeding this returns429 Too Many Requests. A failed run is retried up to 3 attempts in total.
Credits
Each enrichment step consumes credits at the standard API rate. Non-enrichment steps (condition, delay, webhook, transform, export) are free.Was this page helpful?