Waymark / Routes / intercom.com validate Intercom Fin Agent API webhooks via HMAC signature and enable SSE streaming for real-time replies
domain: intercom.com · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checked community attestations: 0✓ / 0✗
Steps Open Deploy > Fin Agent API in the Intercom workspace and generate an API key Configure a callback URL under webhook settings so Fin events are delivered server-side Save the callback URL, which triggers generation of a webhook signing secret (empty until the first save) Validate inbound webhooks by computing an HMAC-SHA256 signature over the request body and comparing it to the X-Fin-Agent-API-Webhook-Signature header Optionally connect to the sse_subscription_url returned by /fin/start or /fin/reply to receive fin_reply_chunk streaming events Render chunks progressively in a custom UI to reduce time-to-first-token Known gotchas The signing secret only appears after the first callback URL save — capture it immediately since it is not re-displayed later Each SSE chunk carries the full accumulated answer text so far, not a delta — appending chunks naively duplicates content Webhook delivery and SSE streaming are independent mechanisms; running both means deduplicating events on your side
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