Documentation Menu

Endpoints and capture URLs

An endpoint is an authenticated configuration record. Its capture URL is the public HTTP URL that a sender calls to deliver a webhook.

Request flow

  1. A provider sends a POST request to /webhook/<endpointId>.
  2. Hookmetry resolves the endpoint and verifies that it is active.
  3. Hookmetry stores the request as a webhook log and runs the configured signature validation.
  4. The dashboard, API, and CLI can retrieve the log only for its owning account.

Capture URL requirements

  • Use the exact URL generated for the endpoint.
  • Send a POST request with a non-empty body.
  • Do not expose a signing secret in a URL, query string, or client-side application.

Was this page helpful?

Your feedback helps us improve the docs.