Skip to main content
POST
/
api
/
workflows
Create Workflow
curl --request POST \
  --url https://encrata.com/api/workflows \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "description": "<string>",
  "trigger": {},
  "steps": [
    {}
  ],
  "template_id": "<string>"
}
'

Documentation Index

Fetch the complete documentation index at: https://docs.encrata.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Authentication

Requires a JWT token or API key in the Authorization header. 
Authorization: Bearer YOUR_TOKEN

​
Request

​
name
string
required
Workflow display name.
​
description
string
Human-readable description of what the workflow does.
​
trigger
object
Trigger configuration. Types: manual, webhook, schedule, file_upload, monitor_event.
​
steps
array
Array of step objects. Each step has id, type, and config.
​
template_id
string
Clone from an existing template instead of defining steps manually.

​
Step types

TypeDescription
email_lookupEnrich an email address
phone_lookupEnrich a phone number
company_lookupEnrich a company
domain_lookupDomain intelligence
ip_lookupIP geolocation & threat data
darkweb_lookupDark web breach search
conditionBranch logic (if/else)
delayWait before continuing
webhookSend HTTP request
transformTransform data between steps

​
Example request

curl -X POST "https://encrata.com/api/workflows" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Lead enrichment pipeline",
    "trigger": { "type": "webhook" },
    "steps": [
      { "id": "step1", "type": "email_lookup", "config": { "field": "email" } },
      { "id": "step2", "type": "condition", "config": { "expression": "step1.company != null" } },
      { "id": "step3", "type": "company_lookup", "config": { "field": "step1.company" } },
      { "id": "step4", "type": "webhook", "config": { "url": "https://hooks.example.com/enriched", "method": "POST" } }
    ]
  }'

​
Response

Returns the created workflow object. 
{
  "id": "wf_abc123",
  "name": "Lead enrichment pipeline",
  "status": "active",
  "trigger": { "type": "webhook" },
  "steps": [...],
  "webhook_url": "https://encrata.com/api/workflows/ingest/tok_xyz789",
  "created_at": "2026-06-01T10:00:00Z"
}