Skip to content

Webhook Scheduled Jobs

Use a scheduled webhook when you want echoValue to call your webhook URL on a cron schedule.

Use crontab.echovalue.dev to generate the schedule.cron value.

What you get

A recurring webhook trigger based on a 5-field cron expression
An IANA timezone such as Europe/Rome
The scheduled-run payload documented in Webhook Payloads
2 credits charged for each scheduled execution

Minimal setup

cURL
JavaScript

curl 'https://api.echovalue.dev/webhook' \
  -H 'x-token: mytoken' \
  -H 'Content-Type: application/json' \
  -d '{
    "webhookId": "daily-sync",
    "url": "https://example.com/hooks/daily-sync",
    "schedule": {
      "cron": "0 9 * * *",
      "timezone": "Europe/Rome"
    }
  }'

fetch('https://api.echovalue.dev/webhook', {
  method: 'POST',
  headers: {
    'x-token': 'mytoken',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    webhookId: 'daily-sync',
    url: 'https://example.com/hooks/daily-sync',
    schedule: {
      cron: '0 9 * * *',
      timezone: 'Europe/Rome'
    }
  })
});

Example response

{
  "webhookId": "daily-sync",
  "webhook": "https://example.com/hooks/daily-sync",
  "headers": {},
  "schedule": {
    "cron": "0 9 * * *",
    "timezone": "Europe/Rome",
    "active": true,
    "nextRunAt": "2026-04-24T07:00:00.000Z"
  },
  "hash": "a1b2c3d4e5f6..."
}

Field rules

schedule is required in this mode.
Do not send format, template, options, or includeAttachments together with schedule.
Scheduled webhooks do not return an email field.

Good fits

Daily sync jobs
Scheduled digests or reminders
Lightweight cron-style automation against your own endpoint

See also: