{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-echosync-webhooks/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Quick Reference"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"quick-reference","__idx":0},"children":["Quick Reference"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["One-page lookup for all technical specifications. Explanations live in the linked pages."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"delivery-specifications","__idx":1},"children":["Delivery Specifications"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Specification"},"children":["Specification"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Value"},"children":["Value"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Protocol"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["HTTPS only (valid CA-issued certificate, TLS 1.2+)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Method"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["POST"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Content type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["application/json"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response timeout"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["15 seconds"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Success codes"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["200 OK"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["202 Accepted"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["204 No Content"]},"; anything else retries"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Retry pattern"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["5→10→20→40→80 min, repeating; max delay 80 min (",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/echosync-webhooks/reliability"},"children":["details"]},")"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Deregistration threshold"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Per webhook (event type): 25 consecutive failures ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["and"]}," 2+ days elapsed; any success resets both"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Signature"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["HMAC-SHA256 over raw body, base64-encoded, using your Signing Secret"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Retry payload"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Identical across retries; only delivery headers change"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"source-ip-addresses-for-allowlisting","__idx":2},"children":["Source IP Addresses (for allowlisting)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Static egress IPs, guaranteed not to change. Allowlist all four; the reserved pair may come into use without notice."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Status"},"children":["Status"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"IP addresses"},"children":["IP addresses"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Active"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["3.19.83.191"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"code","attributes":{},"children":["18.118.90.214"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Reserved"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["32.188.140.83"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"code","attributes":{},"children":["35.80.104.162"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"request-headers","__idx":3},"children":["Request Headers"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Header"},"children":["Header"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Purpose"},"children":["Purpose"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X-Echo-Hmac-SHA256"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Payload signature; verify with your Signing Secret"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X-Echo-Timestamp"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Current attempt timestamp (UTC ISO 8601)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X-Echo-Timestamp-Original"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["First attempt timestamp"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X-Echo-Retry-Attempt"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["0"]}," initial, increments per retry"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X-Echo-Webhook-Id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Unique event Id; use for idempotency"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Authorization"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["OAuth bearer token or Basic Auth credentials, if configured"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["API key / custom headers"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["As configured at registration"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Details and retry behavior: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/echosync-webhooks/technical-implementation"},"children":["Receiving & Verifying Webhooks"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"signing-secret-required","__idx":4},"children":["Signing Secret (Required)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You create it and give it to Echo at registration; Echo does not assign it. Echo signs every payload with it; you verify. Not to be confused with endpoint authentication below, or with an OAuth ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["client_secret"]},"."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Requirement"},"children":["Requirement"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Specification"},"children":["Specification"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Length"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["24–128 characters"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Required characters"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1 uppercase, 1 lowercase, 1 number"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Special characters"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Recommended, not required"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Allowed symbols"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"@ # $ % & * ! ? [ ] { } ( ) < > + - _ . , : ; ~ ` ^ | \\ /\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"endpoint-authentication-optional-recommended","__idx":5},"children":["Endpoint Authentication (Optional, Recommended)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Credentials Echo presents so your endpoint/gateway accepts the request. Does not replace the Signing Secret."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Method"},"children":["Method"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Configuration"},"children":["Configuration"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API key"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Your header name + value, sent on every request"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Basic Auth"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Header pair: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Authorization"]}," + ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Basic <base64(username:password)>"]},"; mutually exclusive with OAuth"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["OAuth 2.0"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Client credentials flow: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["endpoint"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["client_id"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["client_secret"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["grant_type=client_credentials"]}," (+ optional ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["scope"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["audience"]},")"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Custom headers"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Any name/value pairs, sent on every request"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"onboarding-at-a-glance","__idx":6},"children":["Onboarding at a Glance"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Step"},"children":["Step"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Action"},"children":["Action"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Create Signing Secret; prepare separate testing + production URLs"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["2"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Email registration to Technical Integrations"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["3"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Validate test payloads in the testing environment"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["4"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Confirm results; request production activation"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Full walkthrough: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/echosync-webhooks/getting-started"},"children":["Onboarding & Registration"]}]}]},"headings":[{"value":"Quick Reference","id":"quick-reference","depth":1},{"value":"Delivery Specifications","id":"delivery-specifications","depth":2},{"value":"Source IP Addresses (for allowlisting)","id":"source-ip-addresses-for-allowlisting","depth":2},{"value":"Request Headers","id":"request-headers","depth":2},{"value":"Signing Secret (Required)","id":"signing-secret-required","depth":2},{"value":"Endpoint Authentication (Optional, Recommended)","id":"endpoint-authentication-optional-recommended","depth":2},{"value":"Onboarding at a Glance","id":"onboarding-at-a-glance","depth":2}],"frontmatter":{"id":"quick-reference","title":"Quick Reference","seo":{"title":"Quick Reference"}},"lastModified":"2026-10-22T19:54:40.552Z","pagePropGetterError":{"message":"","name":""}},"slug":"/echosync-webhooks/quick-reference","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}