Webhook

The webhook API has two mutually exclusive modes:

1. Inbound Email Webhook echoValue assigns an opaque mailbox address in the form <mailboxId>@hook.echovalue.dev. Every received email is forwarded to your webhook URL.
2. Scheduled Webhook echoValue calls your webhook URL on a recurring schedule defined by a 5-field cron expression and an IANA timezone.

Each webhook is managed through a public webhookId. If you omit it when creating a webhook, echoValue uses default.

Tools

• Use crontab.echovalue.dev to generate the 5-field cron expression for schedule.cron.
• Use webhook.echovalue.dev to create a temporary HTTPS webhook URL for testing.

Pick The Right Mode

Need	Mode	What you send	What you get back	Payload
Turn inbound email into HTTP calls	Inbound Email Webhook	url plus optional format, template, options, includeAttachments	An opaque email address	Inbound email payload or transformed format payload
Run recurring HTTP callbacks	Scheduled Webhook	url plus schedule	Schedule metadata such as nextRunAt	Scheduled-run payload
Verify delivery manually	Test Webhook	Existing webhookId	Delivery result with success	Test payload
Send to Slack, Discord, Teams, Telegram, or PagerDuty	Inbound Email Webhook with format	Platform-specific format and options	An opaque email address	Platform-native payload

Caution

A webhook is either mailbox-based or scheduled, never both. Do not send schedule together with mailbox-only fields such as format, template, options, or includeAttachments.

Endpoint Reference

Page	Endpoint
Create Webhook	POST /webhook
List Webhooks	GET /webhook
Get Webhook	GET /webhook/<webhookId>
Update Webhook	PUT /webhook/<webhookId> and PATCH /webhook/<webhookId>
Delete Webhook	DELETE /webhook/<webhookId>
Test Webhook	POST /webhook/<webhookId>/test
Webhook Payloads	Delivery payload schemas

Guides

Guide	When to use it
Webhook Inbound Email	You want an email address that forwards inbound email to Slack, Discord, PagerDuty, or your own endpoint
Webhook Scheduled Jobs	You want cron-style webhook execution without any mailbox address

Format Adapters

Format adapters apply only to the inbound email mode.

Format	Platform
slack	Slack Incoming Webhooks
discord	Discord Webhooks
teams	Microsoft Teams
telegram	Telegram Bot API
pagerduty	PagerDuty Events API v2
custom	Custom JSON template

Without a format, the raw inbound email payload is forwarded as-is. Scheduled webhooks always deliver the scheduled-run JSON payload.

Pricing

Operation	Cost
Configure webhook	1 credit
Get webhook config	1 credit
Delete webhook	1 credit
Test webhook	1 credit
Scheduled cron run	2 credits
Email processed (no attachments)	2 credits
Email processed (with attachments)	5 credits