Schedules & Webhooks

Schedules and Webhooks let workflows run automatically without manual intervention. Both are configured per-workflow and live in the Deploy panel.

Schedules

A Schedule fires a workflow on a recurring cron expression.

Creating a schedule

POST /workspaces/:wId/pods/:pId/schedules
 
{
  "workflowId": "wf_abc123",
  "name": "Daily digest",
  "cronExpression": "0 9 * * 1-5",
  "timezone": "America/New_York",
  "enabled": true
}

Linea fires the workflow at each scheduled time and passes an empty input. Add a Start node to your workflow to handle the trigger.

Cron syntax

Standard 5-field cron: minute hour day-of-month month day-of-week

API Endpoints

Webhooks

A Webhook fires a workflow when an HTTP POST request is received at its unique URL.

How it works

1. Create a webhook for a workflow — Linea generates a unique trigger URL
2. Configure your external service (GitHub, Stripe, Zapier, etc.) to POST to that URL
3. Linea forwards the request body as the workflow's input

Trigger URL

POST https://api.getlinea.ai/v1/webhooks/:webhookId/trigger

The request body is passed directly as the workflow input — your nodes can access it via {{input.field}}.

Securing a webhook

Set a secret when creating the webhook. Linea will verify an X-Webhook-Signature HMAC header on each incoming request and reject requests that don't match.

POST /workspaces/:wId/pods/:pId/webhooks
 
{
  "workflowId": "wf_abc123",
  "name": "GitHub push events",
  "secret": "your-signing-secret",
  "enabled": true
}

API Endpoints

Testing without a live URL

Use the Chat Preview panel in the workflow builder to simulate any trigger payload locally. Switch to JSON mode, paste your payload, and the workflow runs immediately — no webhook URL or signing needed.