Create Workflow

Create a new automation workflow with triggers and steps.

POST /api/workflows

Create Workflow

cURL

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>"
}
'

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

Type	Description
email_lookup	Enrich an email address
phone_lookup	Enrich a phone number
company_lookup	Enrich a company
domain_lookup	Domain intelligence
ip_lookup	IP geolocation & threat data
darkweb_lookup	Dark web breach search
condition	Branch logic (if/else)
delay	Wait before continuing
webhook	Send HTTP request
transform	Transform data between steps

Example request

cURL

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"
}