Skip to main content
The same information a run summary carries, in a shape another system can act on. Added in workspace settings by an admin, HMAC-signed, retried with backoff, and every attempt kept with its request and its response so a failure is debuggable from your side.

Adding an endpoint

Webhooks are configured per workspace, by an admin, in Settings → Developer → Webhooks. Each endpoint chooses which of the six events it wants; an endpoint subscribed to signal.urgent also receives that signal’s ordinary signal.created delivery unless it opts out of it separately, because the two answer different questions (“a signal arrived” versus “a signal arrived that clears your urgency bar”). Endpoint limits differ by plan. See openpulse.cloud/pricing.

The envelope

Every delivery has the same outer shape. data is what differs by event, and test: true marks a delivery from the Send test button, so a connectivity check never becomes a real lead in your CRM.

Verifying a delivery

Every request carries an x-openpulse-signature header: an HMAC-SHA256 over the raw request body, using the signing secret shown once when the endpoint is created. Recompute it and compare, in constant time rather than with ===, before trusting a payload:
An unverified delivery is a POST from anyone who finds the URL, not proof it came from Open Pulse.

Retries and delivery history

A non-2xx response is retried with backoff. Every attempt (timestamp, response status, response body) is kept and visible in Settings → Developer → Webhooks, so a failure is debuggable from your side rather than something you have to reproduce. The last 20 delivery attempts are visible per endpoint, and you can send a test event to check an integration before it has to work for real.

Responding

Any 2xx marks a delivery accepted. Anything else, including a timeout, is treated as a failure and retried. Respond quickly and do the actual work asynchronously; a webhook handler that blocks on downstream processing is the most common cause of a workspace’s endpoint racking up retries.

Events

The six events, each with the exact payload a POST to your endpoint carries.

MCP & Agents

The other machine surface: an assistant reading the workspace live, rather than being pushed to.

API reference

Pull the same data on demand with a workspace API key.

Getting results out

Email, urgency alerts and CSV export: the routes built for a person rather than a machine.