List Webhooks

GET https://api.echovalue.dev/webhook

Returns all configured webhooks for your wallet, including inbound email webhooks and scheduled webhooks.

Request

Headers:

Header	Description
`x-token`	Your API token

Response

200 OK — JSON object.

{
  "webhooks": [
    {
      "webhookId": "inbox-alerts",
      "webhook": "https://example.com/hooks/inbox-alerts",
      "headers": {},
      "format": "slack",
      "options": {},
      "includeAttachments": true,
      "email": "r_abcd1234@hook.echovalue.dev",
      "hash": "a1b2c3d4e5f6..."
    },
    {
      "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",
        "lastRunAt": "2026-04-23T07:00:00.000Z",
        "lastStatus": "success"
      },
      "hash": "a1b2c3d4e5f6..."
    }
  ]
}

Field	Type	Description
`webhooks`	array	Array of webhook configurations

Webhook entry fields:

Field	Type	Description
`webhookId`	string	Public webhook identifier used for get/update/delete/test operations
`webhook`	string	Configured callback URL
`headers`	object	Custom headers
`format`	string	Configured native format, if any
`template`	object	Custom template object when `format` is `custom`
`options`	object	Format-specific options; sensitive values are redacted
`includeAttachments`	boolean	Whether attachments are included in webhook payloads. Returned only for inbound email webhooks.
`schedule`	object	Scheduling metadata for scheduled webhooks
`email`	string	Opaque mailbox address that triggers this webhook. Returned only for inbound email webhooks.
`hash`	string	SHA256 hash of your token

Reading The Result

If an entry has email, it is an inbound email webhook.
If an entry has schedule, it is a scheduled webhook.
If an entry has format, the inbound email payload is transformed before delivery.
Scheduled entries do not include mailbox-only fields such as format, template, options, or includeAttachments.

Response headers:

Header	Description
`x-balance`	Wallet balance after this call
`x-cost`	Credits consumed

See Response Headers for details.

Status Codes

Status	Meaning
`200`	Configuration list returned
`401`	Invalid token
`402`	Insufficient credits

Examples

curl 'https://api.echovalue.dev/webhook' \
  -H 'x-token: mytoken'