Echopoint documentation
Echopoint is a webhook testing and API flow automation platform. You capture webhooks live, build visual API flows with a real assertions engine, and run those flows from the cloud, your own infrastructure, or CI.
The four pillars
Section titled “The four pillars”- Live webhook capture. Create an inbound endpoint with just a name and get a capture URL immediately. Requests stream into the app in real time over SSE, and you inspect headers, query parameters, and bodies per request. See Webhook testing.
- Flows with assertions. Chain HTTP requests on a visual canvas using Request, Delay, and Module nodes. Extract values from responses and assert on them with 14 operators — every assertion is recorded with expected vs actual, even when it passes. See Building flows and Outputs & assertions.
- Run anywhere. Launch flows from the UI, the CLI, the API, or a GitHub Action. Executions run on the managed cloud runner, on a self-hosted runner in your infrastructure, or as an ephemeral runner inside a CI job — with live node-by-node progress either way. See Runners and CLI.
- OpenAPI import and sync. Turn a spec into a collection of runnable requests in one import, then keep the collection reconciled as the spec changes — with a drift history of added, changed, and removed operations. See OpenAPI import & sync.
Mental model
Section titled “Mental model”Six building blocks make up the product. Each maps to a section of the app sidebar and a section of these docs:
- Webhook endpoints — inbound capture URLs of the form
https://api.echopoint.dev/webhook/{id}. No auth required to send; every request is stored and streamed live. → Webhook testing - Collections and requests — saved, executable HTTP requests organized in collections with folders. Built manually in the workbench or generated from an OpenAPI spec. → Request workbench
- Flows — visual graphs of Request, Delay, and Module nodes connected by success and error edges, with outputs and assertions per node. → Building flows
- Executions and runners — individual flow runs with per-node results, assertion records, and live SSE progress. Executions are claimed by cloud, self-hosted, or ephemeral runners. → Executions & live runs, Runners
- Environments — organization-level default variables with named overlays such as
stagingorprod, plus flow-level variables. Pick an environment at launch. → Environments & variables - API keys — org-scoped keys with scoped permissions (for example
flows:execute) and a curatedcipreset, used by the CLI, the API, and the GitHub Action. → API keys & permissions
Where to start
Section titled “Where to start”If you are new, follow Getting started. It walks the full path: sign in, capture a webhook live, import an OpenAPI spec, build a flow with an assertion, and run it from CI.
If you already know what you need:
- Test and inspect webhooks → Webhook testing
- Execute saved requests → Request workbench
- Import or sync a spec → OpenAPI import & sync
- Build and version flows → Building flows, Versions & publishing
- Automate in CI → CLI, GitHub Action
- Call the API directly → API reference
Next steps
Section titled “Next steps”- Getting started — the end-to-end walkthrough
- Webhook testing — capture and inspect requests live
- Building flows — nodes, edges, and the canvas
- CLI — install and run flows from a terminal or CI