Skip to main content
Standard Webhooks is a common format for signed webhooks: a webhook-id, a webhook-timestamp and a webhook-signature header. Webhook Trap’s Standard Webhooks pack covers any sender that follows it.

Point your provider at your capture URL

Paste the capture URL (https://in.webhooktrap.dev/c/ followed by a 12-character key) as the endpoint in your provider’s webhook settings. Webhook Trap recognises a delivery when it has both webhook-id and webhook-signature headers, reads the event type from the body’s type field and the event id from webhook-id, and names the sender from its User-Agent.

Configure the agent

webhooktrap.yml
If you leave out secret, the agent looks for WEBHOOK_SECRET, the name in the Standard Webhooks pack.
Your signing secret stays on your machine. webhooktrap.yml holds only the name of the environment variable (secret: env:NAME). The agent reads the value when it signs a delivery, strips every known secret variable from the environment of probe and reset commands, and refuses to write or upload a run document that contains the secret. The server learns the variable’s name, never its value.
The signature covers a timestamp, with a 300-second tolerance. Without the secret the agent can’t send a valid delivery, and the run stops as Couldn’t start with the reason needs_secret.

What the scenarios do for Standard Webhooks

The 10 s budget is the Webhook Trap default. The spec’s 15 to 30 seconds is guidance for senders, not a limit for your handler.