Get Webhook

GET https://api.echovalue.dev/webhook/<webhookId>

Returns a single webhook configuration. Responses differ slightly for inbound email and scheduled webhooks.

Note

Cost: 1 credit

Request

Headers:

Header	Description
x-token	Your API token

Path parameters:

Parameter	Type	Description	Required
webhookId	string	Public webhook identifier to retrieve	Yes

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

Single Webhook Response

200 OK — JSON object.

{
  "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
webhookId	string	Public webhook identifier used for update/delete/test operations
webhook	string	Your configured callback URL
headers	object	Custom headers (values are redacted)
format	string	Configured native format, if any (e.g. slack, telegram, custom)
template	object	Custom template object (only present when format is custom)
options	object	Format-specific options (sensitive values like routing_key are redacted as ***)
includeAttachments	boolean	Whether attachments are included in webhook payload. Returned only for inbound email webhooks.
schedule	object	Cron schedule configuration and runtime status 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 — use this to identify incoming payloads

Interpreting The Response

• email present: this webhook is waiting for inbound email.
• schedule present: this webhook runs on a schedule.
• format present: inbound email is transformed into a provider-specific payload before delivery.
• Scheduled webhook responses omit mailbox-only fields such as format, template, options, and 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	Webhook returned
400	Invalid request
401	Invalid token
402	Insufficient credits
404	Webhook not found