Assert on a webhook in a test

Start the wait, then trigger the code that sends the webhook. The TypeScript SDK and the CLI set receivedAfter to the moment of the call, so a request that arrived earlier does not match. Install the published client and set the same token the CLI reads:

npm install @devhelm/sdk@1.8.0
export DEVHELM_API_TOKEN=dh_live_xxxxxxxx

TypeScript

import { Devhelm } from "@devhelm/sdk";

const client = new Devhelm({
  token: process.env.DEVHELM_API_TOKEN!,
});

const event = await client.inboxes.wait("<inbox-id>", {
  timeoutMs: 30_000,
  http: { method: "POST", pathPrefix: "/hooks/stripe" },
});

console.log(event.id, event.method, event.path, event.text());

timeoutMs is milliseconds (default 30000, maximum 120000). http.method and http.pathPrefix are optional. event.text() is the captured body. event.json() parses that text. A token scoped to one organization and workspace needs no extra headers. If the token can see more than one workspace, set DEVHELM_ORG_ID and DEVHELM_WORKSPACE_ID before you construct the client. See Authentication.

CLI

devhelm inboxes wait <inbox-id> \
  --timeout-ms 30000 \
  --method POST \
  --path-prefix /hooks/stripe \
  -o json

--timeout-ms is milliseconds. The command prints the event as JSON, including id, method, path, and body.

REST

The API looks back 60 seconds when you omit receivedAfter. Pass receivedAfter yourself when you need the same “from this call onward” window the SDK and CLI use.

API

curl -X POST "https://api.devhelm.io/api/v1/webhook/inboxes/<inbox-id>/wait" \
  -H "Authorization: Bearer $DEVHELM_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"timeoutMs":30000,"http":{"method":"POST","pathPrefix":"/hooks/stripe"}}'

If nothing arrives before the timeout, the wait ends with HTTP 408.

Next steps

Verify signatures

Recompute the HMAC over the raw body bytes.

Run in CI

One inbox per run, then delete it.

Getting Started

Webhook testing

Monitoring as Code

Monitoring

Incidents

Alerting

Status Data

Email testing

Platform

Common Patterns

Assert on a webhook in a test

TypeScript

CLI

REST

Next steps

Verify signatures

Run in CI

​TypeScript

​CLI

​REST

​Next steps

Verify signatures

Run in CI

TypeScript

CLI

REST

Next steps