Configure and verify Pool Brain Open API webhook callbacks (HMAC-SHA256 signed) for customer/job events

domain: prodapi.poolbrain.com · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Request Open API access by emailing team@poolbrain.com (or via the in-app messenger) -- API keys and initial documentation access are provisioned on request, not self-serve at signup.
  2. Once Open API access is granted, go to Settings > API > Webhooks directly inside the Pool Brain dashboard (dashboard.poolbrain.com) -- webhook creation itself is self-service at this point, no further vendor involvement needed.
  3. Choose which dot-separated, past-tense events to subscribe to (e.g. customer.created, customer.status.changed, job.created, job.one_time.schedule.changed, technician.route.changed) and supply your HTTPS callback URL.
  4. Copy the Signing Secret shown for the webhook subscription; store it server-side to verify incoming payloads.
  5. On receipt, compute HMAC-SHA256 over the raw (unparsed) request body using the signing secret, compare it to the signature header using a constant-time comparison, and reject mismatches.
  6. Return an HTTP 2xx status to acknowledge receipt; Pool Brain retries deliveries that fail due to network errors, timeouts, or non-2xx responses, so make handlers idempotent.

Known gotchas

Related routes

Configure Sign In App webhooks to receive real-time visitor sign-in and sign-out events with HMAC-SHA256 signature verification.
developers.signinenterprise.com · 5 steps · unrated
Register a Finch webhook endpoint and verify signatures with HMAC-SHA256
hr-payroll · 5 steps · unrated
Subscribe to Bob (HiBob) Webhooks v2 and verify event authenticity with the HMAC signature
hr-payroll · 5 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans