API Reference

Quick Start

Leaf Loom works by receiving a webhook POST from your automation tool each time a workflow runs. Your API key is generated when you sign up. Paste the endpoint URL into Zapier, Make, n8n, or any tool that supports webhooks.

POST /api/webhook/log/{user_id}?key={api_key}

Your user ID and API key are both found in the Automations tab of your dashboard. The API key goes in the query string, not the request body.

Webhook API

Response Codes

Payload Reference

Send a JSON body with each webhook call. The API key goes in the URL as a query parameter. Only workflow_name is required; everything else is optional.

POST /api/webhook/log/YOUR_USER_ID?key=YOUR_KEY

{
  "workflow_name": "Send Weekly Report",        // required
  "workflow_id":   "zapier-weekly-001",
  "status":        "success",                    // "success" | "error" — defaults to "success"
  "duration_ms":   1240,
  "platform":      "zapier",                   // defaults to "webhook"
  "error_message": null,
  "extra_data": [                              // optional — add any custom key/value pairs
    { "key": "records_processed", "value": 42 },
    { "key": "triggered_by",      "value": "schedule"  },
    { "key": "environment",      "value": "production" }
  ]
}

How Automations Work

One key, many automations

You use a single API key across all your workflows. Each automation is tracked separately based on its workflow_name field, so you get per-automation scoring without managing multiple keys.

Every unique workflow_name automatically creates a separate automation entry in your dashboard with its own reliability score, grade, and history.

// Workflow 1
POST /api/webhook/log/YOUR_USER_ID?key=YOUR_KEY
{
  "workflow_name": "Email Welcome Sequence",
  "status":        "success",
  "duration_ms":   1240,
  "platform":      "zapier"
}

// Workflow 2 — same key, tracked separately
POST /api/webhook/log/YOUR_USER_ID?key=YOUR_KEY
{
  "workflow_name": "Lead Sync to CRM",
  "status":        "error",
  "duration_ms":   820,
  "error_message": "Field mapping failed",
  "platform":      "make"
}

Health Alerts

Automated checks on every dashboard load

Every time you open your dashboard, Leaf Loom runs two health checks across your automations and surfaces issues at the top of the page — no configuration needed.

Reports & Trends

How scoring builds over time

Score confidence increases as more data is collected. A brand new automation starts ungraded and builds toward a stable score as runs accumulate. The score equals the success rate percentage. Grades are assigned as follows: A ≥ 95%, B ≥ 85%, C ≥ 75%, D ≥ 60%, F < 60%.

Responses

Custom Scoring Rules

Custom scoring rules let you adjust an automation's reliability score beyond the raw success rate. Rules are evaluated against every individual run in the selected period — not a merged snapshot. Up to 500 active rules are supported per automation.

Available context fields

Every rule condition and formula can reference these variables. Metric fields are always present. Metadata fields appear automatically as new extra_data keys are received via webhook.

Rule structure

Each rule has an optional condition and a required action. If no condition is set, the rule fires unconditionally on every evaluation.

{
  "name": "Penalise high record count",
  "if": {
    "key": "records_processed",
    "operator": ">",
    "value": "100"
  },
  "action": {
    "type": "static_penalty",
    "value": 10
  }
}

Condition operators

Action types

{ "type": "static_penalty", "value": 10 }

{ "type": "static_bonus", "value": 5 }

{ "type": "dynamic_formula", "formula": "(avg_duration - 1000) / 500" }

Limits

Examples

curl -X POST "http://localhost:8000/api/webhook/log/YOUR_USER_ID?key=YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"workflow_name":"My Workflow","status":"success","duration_ms":850}'

await fetch('http://localhost:8000/api/webhook/log/YOUR_USER_ID?key=YOUR_KEY', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    workflow_name: 'My Workflow',
    status: 'success',
    duration_ms: 850
  })
});