[{"data":1,"prerenderedAt":208},["ShallowReactive",2],{"doc:\u002Fwebhooks":3},{"page":4,"toc":192},{"path":5,"title":6,"description":7,"blocks":8},"\u002Fwebhooks","Webhooks","Get a signed HTTPS request the moment a database release is ready, instead of polling for new files.",[9,12,14,32,34,39,62,65,67,75,78,80,87,89,92,121,125,151,153,156,163,166,174],{"type":10,"text":11},"p","Webhooks let ipscope tell your systems when something happens to your databases: the first release of a new database is ready, a new release replaces the current one, or a build did not complete. Point a webhook at your deployment pipeline and it can download and roll out the new file within minutes of it being built, with no timer and no polling.",{"type":10,"text":13},"A webhook is a URL on your server. When an event happens, ipscope sends it a `POST` request with a JSON body describing the event, signed with a secret only you and ipscope know, much like webhooks from other platforms you may already use.",{"type":15,"columns":16,"rows":19},"table",[17,18],"Event","Sent when",[20,23,26,29],[21,22],"`database.created`","The first release of a database is ready to download.",[24,25],"`database.updated`","A new release of the database is ready (for example after a refresh, a field upgrade or a rebuild). Only sent when the release actually changed.",[27,28],"`database.build_failed`","A build did not complete. The current release, if there is one, stays available.",[30,31],"`webhook.test`","You pressed **Send test event** in the dashboard or called the [test route](\u002Fwebhooks\u002Fapi#send-a-test-event).",{"type":10,"text":33},"Full payloads for each event are on [Event types & payloads](\u002Fwebhooks\u002Fevents).",{"type":35,"level":36,"text":37,"id":38},"heading",2,"Add an endpoint in the dashboard","add-an-endpoint-in-the-dashboard",{"type":40,"steps":41},"steps",[42,47,52,57],{"title":43,"blocks":44},"Open API → Webhooks",[45],{"type":10,"text":46},"Sign in at [https:\u002F\u002Fdashboard.ipscope.io](https:\u002F\u002Fdashboard.ipscope.io), open **API → Webhooks** and choose **Add endpoint**.",{"title":48,"blocks":49},"Enter the URL and choose events",[50],{"type":10,"text":51},"Enter a public `https:\u002F\u002F` URL on your server, an optional description (such as `Prod updater`), and the events it should receive. Leave every event selected unless the endpoint only cares about some of them.",{"title":53,"blocks":54},"Copy the signing secret",[55],{"type":10,"text":56},"Each endpoint has its own signing secret: `whsec_` followed by 43 base64url characters. Store it with your other secrets (for example as `IPSCOPE_WEBHOOK_SECRET`) and use it to [verify every request](\u002Fwebhooks\u002Fverifying).",{"title":58,"blocks":59},"Send a test event",[60],{"type":10,"text":61},"Choose **Send test event**. Your endpoint receives a `webhook.test` event, and the delivery shows up in the endpoint's history with the status code your server answered.",{"type":35,"level":36,"text":63,"id":64},"Add an endpoint with the API","add-an-endpoint-with-the-api",{"type":10,"text":66},"The same endpoints can be managed with an API key, which suits infrastructure-as-code. The response includes the `secret`; see [Managing endpoints](\u002Fwebhooks\u002Fapi) for every route.",{"type":68,"samples":69},"code",[70],{"label":71,"lang":72,"code":73,"html":74},"curl","bash","curl -sS -X POST \"https:\u002F\u002Fapi.ipscope.io\u002Fv1\u002Fwebhooks\" \\\n  -H \"Authorization: Bearer $IPSCOPE_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"url\":\"https:\u002F\u002Fexample.com\u002Fhooks\u002Fipscope\",\"description\":\"Prod updater\",\"events\":[\"database.updated\"]}'","\u003Cpre class=\"shiki ipscope\" style=\"background-color:var(--shiki-background);color:var(--shiki-foreground)\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-function)\">curl\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string)\"> -sS\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string)\"> -X\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string)\"> POST\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\"> \"https:\u002F\u002Fapi.ipscope.io\u002Fv1\u002Fwebhooks\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> \\\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-string)\">  -H\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\"> \"Authorization: Bearer $IPSCOPE_API_KEY\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> \\\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-string)\">  -H\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\"> \"Content-Type: application\u002Fjson\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> \\\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-string)\">  -d\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\"> '{\"url\":\"https:\u002F\u002Fexample.com\u002Fhooks\u002Fipscope\",\"description\":\"Prod updater\",\"events\":[\"database.updated\"]}'\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>",{"type":35,"level":36,"text":76,"id":77},"What a delivery looks like","what-a-delivery-looks-like",{"type":10,"text":79},"Every delivery is a `POST` with `Content-Type: application\u002Fjson` and `User-Agent: ipscope-webhooks\u002F1.0 (+https:\u002F\u002Fipscope.io)`. The `IPScope-*` headers identify the event and the attempt:",{"type":68,"samples":81},[82],{"label":83,"lang":84,"code":85,"html":86},"Request to your endpoint","http","POST \u002Fhooks\u002Fipscope HTTP\u002F1.1\nHost: example.com\nContent-Type: application\u002Fjson\nUser-Agent: ipscope-webhooks\u002F1.0 (+https:\u002F\u002Fipscope.io)\nIPScope-Signature: t=1793761929,v1=d48dd86bdda97d482f2cc4a81cc14e88692654757a8c027f39c1d95a52ad8776\nIPScope-Event-Id: evt_8f0c2e5d9b1a4c7e8f0c2e5d9b1a4c7e\nIPScope-Event-Type: database.updated\nIPScope-Delivery-Id: e8b6d4c2-a0f9-4e7d-8c5b-3a1f9e7d5c40\nIPScope-Delivery-Attempt: 1\n\n{\"id\":\"evt_8f0c2e5d9b1a4c7e8f0c2e5d9b1a4c7e\",\"object\":\"event\",\"type\":\"database.updated\",\"api_version\":\"2026-11-04\",\"created_at\":\"2026-11-04T03:12:09.512Z\",\"data\":{\"database\":{\"id\":\"3f6c1a52-8d4e-4b7a-9c21-5e0f7d9a1b34\",\"name\":\"Fraud signals\",\"update_schedule\":\"daily\"},\"release\":{\"id\":\"rel_4c1e9a7b3f20_9d2b6e8a1c54\",\"previous_release_id\":\"rel_7b3e0d9a52c1_e64f1a8c3d07\",\"built_at\":\"2026-11-04T03:10:44.000Z\",\"files\":[{\"format\":\"mmdb\",\"filename\":\"3f6c1a52-8d4e-4b7a-9c21-5e0f7d9a1b34_04112026.mmdb\",\"sha256\":\"2c26b46b68ffc68ff99b453c1d30413413422d706483bfa0f98a5e886266e7ae\",\"size_bytes\":81234567,\"download_url\":\"https:\u002F\u002Fapi.ipscope.io\u002Fv1\u002Fmmdb\u002Ffiles\u002Frel_4c1e9a7b3f20_9d2b6e8a1c54\u002Fmmdb\"},{\"format\":\"csv\",\"filename\":\"3f6c1a52-8d4e-4b7a-9c21-5e0f7d9a1b34_04112026.csv.gz\",\"sha256\":\"fcde2b2edba56bf408601fb721fe9b5c338d10ee429ea04fae5511b68fbf8fb9\",\"size_bytes\":64120933,\"download_url\":\"https:\u002F\u002Fapi.ipscope.io\u002Fv1\u002Fmmdb\u002Ffiles\u002Frel_4c1e9a7b3f20_9d2b6e8a1c54\u002Fcsv\"},{\"format\":\"parquet\",\"filename\":\"3f6c1a52-8d4e-4b7a-9c21-5e0f7d9a1b34_04112026.parquet\",\"sha256\":\"baa5a0964d3320fbc0c6a922140453c8513ea24ab8fd0577034804a967248096\",\"size_bytes\":52877410,\"download_url\":\"https:\u002F\u002Fapi.ipscope.io\u002Fv1\u002Fmmdb\u002Ffiles\u002Frel_4c1e9a7b3f20_9d2b6e8a1c54\u002Fparquet\"}]},\"build\":{\"id\":\"dbc_5e8a2c9f1b7d4e3a6c0f\"}}}","\u003Cpre class=\"shiki ipscope\" style=\"background-color:var(--shiki-background);color:var(--shiki-foreground)\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">POST\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> \u002Fhooks\u002Fipscope \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">HTTP\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">\u002F\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\">1.1\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-string-expression)\">Host\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">:\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string)\"> example.com\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-string-expression)\">Content-Type\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">:\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string)\"> application\u002Fjson\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-string-expression)\">User-Agent\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">:\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string)\"> ipscope-webhooks\u002F1.0 (+https:\u002F\u002Fipscope.io)\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-string-expression)\">IPScope-Signature\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">:\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string)\"> t=1793761929,v1=d48dd86bdda97d482f2cc4a81cc14e88692654757a8c027f39c1d95a52ad8776\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-string-expression)\">IPScope-Event-Id\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">:\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string)\"> evt_8f0c2e5d9b1a4c7e8f0c2e5d9b1a4c7e\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-string-expression)\">IPScope-Event-Type\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">:\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string)\"> database.updated\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-string-expression)\">IPScope-Delivery-Id\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">:\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string)\"> e8b6d4c2-a0f9-4e7d-8c5b-3a1f9e7d5c40\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-string-expression)\">IPScope-Delivery-Attempt\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">:\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string)\"> 1\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">{\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">\"id\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">:\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\"evt_8f0c2e5d9b1a4c7e8f0c2e5d9b1a4c7e\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">\"object\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">:\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\"event\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">\"type\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">:\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\"database.updated\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">\"api_version\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">:\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\"2026-11-04\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">\"created_at\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">:\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\"2026-11-04T03:12:09.512Z\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">\"data\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">:\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">{\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">\"database\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">:\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">{\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">\"id\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">:\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\"3f6c1a52-8d4e-4b7a-9c21-5e0f7d9a1b34\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">\"name\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">:\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\"Fraud signals\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">\"update_schedule\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">:\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\"daily\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">}\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">\"release\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">:\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">{\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">\"id\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">:\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\"rel_4c1e9a7b3f20_9d2b6e8a1c54\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">\"previous_release_id\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">:\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\"rel_7b3e0d9a52c1_e64f1a8c3d07\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">\"built_at\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">:\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\"2026-11-04T03:10:44.000Z\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">\"files\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">:\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">[{\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">\"format\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">:\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\"mmdb\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">\"filename\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">:\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\"3f6c1a52-8d4e-4b7a-9c21-5e0f7d9a1b34_04112026.mmdb\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">\"sha256\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">:\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\"2c26b46b68ffc68ff99b453c1d30413413422d706483bfa0f98a5e886266e7ae\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">\"size_bytes\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">:\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\">81234567\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">\"download_url\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">:\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\"https:\u002F\u002Fapi.ipscope.io\u002Fv1\u002Fmmdb\u002Ffiles\u002Frel_4c1e9a7b3f20_9d2b6e8a1c54\u002Fmmdb\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">}\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">{\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">\"format\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">:\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\"csv\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">\"filename\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">:\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\"3f6c1a52-8d4e-4b7a-9c21-5e0f7d9a1b34_04112026.csv.gz\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">\"sha256\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">:\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\"fcde2b2edba56bf408601fb721fe9b5c338d10ee429ea04fae5511b68fbf8fb9\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">\"size_bytes\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">:\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\">64120933\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">\"download_url\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">:\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\"https:\u002F\u002Fapi.ipscope.io\u002Fv1\u002Fmmdb\u002Ffiles\u002Frel_4c1e9a7b3f20_9d2b6e8a1c54\u002Fcsv\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">}\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">{\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">\"format\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">:\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\"parquet\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">\"filename\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">:\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\"3f6c1a52-8d4e-4b7a-9c21-5e0f7d9a1b34_04112026.parquet\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">\"sha256\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">:\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\"baa5a0964d3320fbc0c6a922140453c8513ea24ab8fd0577034804a967248096\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">\"size_bytes\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">:\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\">52877410\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">\"download_url\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">:\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\"https:\u002F\u002Fapi.ipscope.io\u002Fv1\u002Fmmdb\u002Ffiles\u002Frel_4c1e9a7b3f20_9d2b6e8a1c54\u002Fparquet\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">}]}\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">\"build\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">:\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">{\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">\"id\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">:\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\"dbc_5e8a2c9f1b7d4e3a6c0f\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">}}}\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>",{"type":10,"text":88},"The body is compact JSON. The order of its keys is not specified and can differ from the examples on these pages, so parse it as JSON and verify the signature over the bytes exactly as received. The signature above is real: it verifies for this body with the sample secret `whsec_8Yh1hqgCFzwujTnRk8AKyREOf2jPvsZ99OoqOrcvrog` at that timestamp.",{"type":35,"level":36,"text":90,"id":91},"Delivery guarantees","delivery-guarantees",{"type":15,"columns":93,"rows":96},[94,95],"Topic","Behavior",[97,100,103,106,109,112,115,118],[98,99],"**Success**","Any `2xx` response within **10 seconds**. The response body is ignored.",[101,102],"**Failure**","Any other status, a timeout, a connection error or a TLS error. Redirects are not followed, so a `3xx` is a failure.",[104,105],"**Retries**","Failed deliveries are retried with back-off, up to **10 attempts over about 2 days** (schedule below). Every attempt carries the same event id and body; the signature timestamp is fresh on each attempt.",[107,108],"**Duplicates**","Delivery is **at least once**: the same event can arrive more than once. Deduplicate by the `IPScope-Event-Id` header (or the body's `id`).",[110,111],"**Ordering**","Not guaranteed. Compare `release.built_at` or release ids rather than relying on arrival order.",[113,114],"**Automatic disabling**","If the last 5 deliveries to an endpoint all failed, each after all of its retries, the endpoint is disabled (`webhook.test` deliveries count too). **While an endpoint is disabled, its events are lost**: no deliveries are created for new events, retries that were still pending are abandoned (`Endpoint disabled`), and nothing is replayed when you turn it back on. Re-enable it in the dashboard or with [`PATCH \u002Fv1\u002Fwebhooks\u002F{id}`](\u002Fwebhooks\u002Fapi#update-an-endpoint) and `{\"enabled\": true}`, then [resend](\u002Fwebhooks\u002Fapi#resend-a-delivery) any delivery you still need.",[116,117],"**Resending**","Any delivery (succeeded, failed or abandoned) can be sent again from the dashboard or with [`POST \u002Fv1\u002Fwebhooks\u002Fdeliveries\u002F{id}\u002Fresend`](\u002Fwebhooks\u002Fapi#resend-a-delivery). It keeps its delivery id and event id and starts a fresh set of 10 attempts.",[119,120],"**History**","Deliveries, with status code, error and duration of the last attempt, are kept for **30 days**.",{"type":35,"level":122,"text":123,"id":124},3,"Retry schedule","retry-schedule",{"type":15,"columns":126,"rows":129},[127,128],"Attempt","Sent",[130,133,136,139,142,145,148],[131,132],"1","As soon as the event happens",[134,135],"2","About 1 minute after attempt 1 failed",[137,138],"3","About 5 minutes later",[140,141],"4","About 30 minutes later",[143,144],"5","About 2 hours later",[146,147],"6","About 5 hours later",[149,150],"7 – 10","About every 10 hours",{"type":10,"text":152},"Each wait varies by up to 10% either way, so endpoints that failed together do not retry together. The `IPScope-Delivery-Attempt` header says which attempt a request is (`1` for the first). `webhook.test` deliveries are retried on the same schedule.",{"type":35,"level":36,"text":154,"id":155},"Endpoint requirements","endpoint-requirements",{"type":157,"items":158},"list",[159,160,161,162],"A public `https:\u002F\u002F` URL of up to 2,048 characters. URLs with credentials in them (`https:\u002F\u002Fuser:pass@…`) are rejected, and any `#fragment` is removed.","The host must be a public internet name or address: single-label hosts (`https:\u002F\u002Fintranet\u002F…`), `localhost` and names ending in `.local`, `.internal`, `.lan`, `.home`, `.corp` or `.localhost` are rejected, as are private, loopback, link-local, documentation and other reserved IP addresses. The name is resolved again on every delivery, and a delivery to a name that now resolves to a private or reserved address fails.","Up to **10 endpoints** per account. Each endpoint can subscribe to any subset of the event types.","Answer with a `2xx` within 10 seconds, even when the work the event starts takes longer.",{"type":35,"level":36,"text":164,"id":165},"Best practices","best-practices",{"type":157,"ordered":167,"items":168},true,[169,170,171,172,173],"**Verify the signature** of every request on the raw body before trusting it ([how](\u002Fwebhooks\u002Fverifying)).","**Respond fast, work later.** Return `2xx` as soon as the request is verified and recorded, then download the new release in a background job.","**Deduplicate** by `IPScope-Event-Id`: retries and resends reuse the same event id.","**Verify the file** after downloading: compare its SHA-256 with the `sha256` in the event before swapping it in ([zero-downtime updates](\u002Fdatabases\u002Fupdating)).","**Do not rely on order.** If two releases arrive close together, keep the one with the newest `built_at`.",{"type":175,"columns":122,"cards":176},"cards",[177,182,187],{"title":178,"text":179,"href":180,"icon":181},"Event types & payloads","The envelope, every event type and a full JSON example of each.","\u002Fwebhooks\u002Fevents","file",{"title":183,"text":184,"href":185,"icon":186},"Verifying signatures","Check `IPScope-Signature` in Node.js, Python, Go, PHP and Ruby, plus complete receivers.","\u002Fwebhooks\u002Fverifying","shield",{"title":188,"text":189,"href":190,"icon":191},"Managing endpoints (API)","Create, update, test and inspect endpoints and deliveries with an API key.","\u002Fwebhooks\u002Fapi","terminal",[193,194,196,198,200,202,203,204,205,206,207],{"id":38,"text":37,"level":36},{"id":195,"text":43,"level":122},"step-open-api-webhooks",{"id":197,"text":48,"level":122},"step-enter-the-url-and-choose-events",{"id":199,"text":53,"level":122},"step-copy-the-signing-secret",{"id":201,"text":58,"level":122},"step-send-a-test-event",{"id":64,"text":63,"level":36},{"id":77,"text":76,"level":36},{"id":91,"text":90,"level":36},{"id":124,"text":123,"level":122},{"id":155,"text":154,"level":36},{"id":165,"text":164,"level":36},1795009045975]