What Belio does when a delivery-receipt callback URL is unreachable.
SMS, WhatsApp, and mobile data delivery receipts use a circuit breaker per callback URL. If your endpoint stays down, Belio opens the circuit and skips further posts to that URL until it tries again.
Acknowledge the callback with HTTP 200 and process it later so you stay under the 5-second call timeout.Each URL has its own breaker. A slow endpoint trips only that URL.While the circuit is open, receipts for that URL are not delivered. They are not replayed when the circuit closes. Do not treat callbacks as the only record of delivery.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Belio Docs","colors":{"primary":"#16A34A","light":"#07C983","dark":"#15803D"},"logo":{"light":"https://mintcdn.com/belio/PDVtnSHUd86QGkzM/logo/light.svg?fit=max\u0026auto=format\u0026n=PDVtnSHUd86QGkzM\u0026q=85\u0026s=b31e8e7e998cd24f1336028d5f506e5f","dark":"https://mintcdn.com/belio/PDVtnSHUd86QGkzM/logo/dark.svg?fit=max\u0026auto=format\u0026n=PDVtnSHUd86QGkzM\u0026q=85\u0026s=9dcad6cb0a886260339146ff6ad87752"},"favicon":"https://mintcdn.com/belio/PDVtnSHUd86QGkzM/favicon.svg?fit=max\u0026auto=format\u0026n=PDVtnSHUd86QGkzM\u0026q=85\u0026s=7356d193b42e3d737119643703ca0798","api":{"playground":{"display":"interactive"},"examples":{"defaults":"required","prefill":true}},"navbar":{"links":[{"href":"mailto:info@belio.co.ke","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://cloud.belio.co.ke"}},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"Website","icon":"link","href":"https://belio.co.ke"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"belio","hasAudioNarration":false,"actualSubdomain":"belio","customDomains":["docs.belio.co.ke"],"gitSource":{"type":"github","owner":"belio-ke","repo":"api-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ac9696c942a2f113b2853bb","collectionId":"3781222d-3a9f-436d-a9bd-299c365482a9","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ac9696c942a2f113b2853bb"},"entitlements":{},"buildId":"6ae4ba983ba31227325ea8c9","clientVersion":"0.0.4021","searchFilterCounts":[{"language":"default","tag":"REST API","count":32},{"language":"default","tag":"Messaging","count":18},{"language":"default","tag":"SMS","count":8},{"language":"default","tag":"Templates","count":8},{"language":"default","tag":"WhatsApp","count":7},{"language":"default","tag":"USSD","count":4},{"language":"default","tag":"Mobile Data","count":3},{"language":"default","tag":"Authentication","count":2},{"language":"default","tag":"Bundles","count":1},{"language":"default","tag":"Campaigns","count":1}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"callbacks/circuit-breaker","slug":"/callbacks/circuit-breaker","pageMetadata":{"title":"Circuit breaker","description":"What Belio does when a delivery-receipt callback URL is unreachable.","href":"/callbacks/circuit-breaker"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"What Belio does when a delivery-receipt callback URL is unreachable.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,p:`p`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{Heading,Mermaid,Note,Table}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Mermaid)_missingMdxReference(`Mermaid`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`SMS, WhatsApp, and mobile data delivery receipts use a circuit breaker per callback URL. If your endpoint stays down, Belio opens the circuit and skips further posts to that URL until it tries again.`}),`\n`,_jsx(Heading,{level:`2`,id:`states`,children:`States`}),`\n`,_jsx(_components.p,{children:`Each callback URL has its own breaker:`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`State`}),_jsx(_components.th,{children:`Behaviour`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Closed`}),_jsx(_components.td,{children:`Callbacks are delivered as usual.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Open`}),_jsx(_components.td,{children:`Callbacks to this URL are skipped. Belio does not contact your endpoint.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Half-open`}),_jsx(_components.td,{children:`One test callback is attempted. Success closes the circuit. Failure re-opens it with a longer wait.`})]})]})]}),`\n`,_jsx(Mermaid,{chart:`stateDiagram-v2\n [*] --> Closed\n Closed --> Open: consecutive failures ≥ max failures\n Open --> HalfOpen: reset timeout elapsed\n HalfOpen --> Closed: test request succeeds\n HalfOpen --> Open: test request fails`}),`\n`,_jsx(Heading,{level:`2`,id:`configuration`,children:`Configuration`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Parameter`}),_jsx(_components.th,{children:`Default`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Max failures`}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`5`})}),_jsx(_components.td,{children:`Consecutive failures within a call timeout window before the circuit opens`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Reset timeout`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`1 minute`})}),_jsx(_components.td,{children:`How long the circuit stays open before moving to half-open and sending a test request`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Max reset timeout`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`10 minutes`})}),_jsx(_components.td,{children:`Cap on the reset timeout, however many times backoff has multiplied it`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Backoff factor`}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`2.0`})}),_jsx(_components.td,{children:`Multiplier applied to the reset timeout after each successive failure. 1 min, 2 min, 4 min…`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Randomization factor`}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`0.2`})}),_jsx(_components.td,{children:`±20% jitter on each reset timeout so several URLs do not retry at the same instant`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Call timeout`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`5 seconds`})}),_jsx(_components.td,{children:`How long Belio waits for your endpoint before counting the attempt as a failure`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`backoff-sequence`,children:`Backoff sequence`}),`\n`,_jsx(_components.p,{children:`With the defaults, successive opens wait this long before a test request (jitter not included):`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Open #`}),_jsx(_components.th,{children:`Reset timeout`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`1st`}),_jsx(_components.td,{children:`1 minute`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`2nd`}),_jsx(_components.td,{children:`2 minutes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`3rd`}),_jsx(_components.td,{children:`4 minutes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`4th`}),_jsx(_components.td,{children:`8 minutes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`5th and later`}),_jsx(_components.td,{children:`10 minutes, capped`})]})]})]}),`\n`,_jsx(Note,{children:_jsx(_components.p,{children:`The ±20% jitter means a 4-minute timeout lands somewhere between 3 min 12 s\nand 4 min 48 s.`})}),`\n`,_jsx(Heading,{level:`2`,id:`if-your-endpoint-is-slow-or-down`,children:`If your endpoint is slow or down`}),`\n`,_jsx(_components.p,{children:`Acknowledge the callback with HTTP 200 and process it later so you stay under the 5-second call timeout.`}),`\n`,_jsx(_components.p,{children:`Each URL has its own breaker. A slow endpoint trips only that URL.`}),`\n`,_jsx(_components.p,{children:`While the circuit is open, receipts for that URL are not delivered. They are not replayed when the circuit closes. Do not treat callbacks as the only record of delivery.`})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Circuit breaker","description":"What Belio does when a delivery-receipt callback URL is unreachable.","href":"/callbacks/circuit-breaker"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"States","slug":"states","depth":2,"children":[]},{"title":"Configuration","slug":"configuration","depth":2,"children":[]},{"title":"Backoff sequence","slug":"backoff-sequence","depth":2,"children":[]},{"title":"If your endpoint is slow or down","slug":"if-your-endpoint-is-slow-or-down","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"belio","siteName":"Belio Docs","title":"Circuit breaker - Belio Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-30T15:41:16.081Z","originalFileLocation":"callbacks/circuit-breaker.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"What Belio does when a delivery-receipt callback URL is unreachable.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Belio Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/belio/KPlCfFwC9xTyKoL9/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/belio/KPlCfFwC9xTyKoL9/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/belio/KPlCfFwC9xTyKoL9/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/belio/KPlCfFwC9xTyKoL9/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/belio/KPlCfFwC9xTyKoL9/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/belio/KPlCfFwC9xTyKoL9/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/belio/KPlCfFwC9xTyKoL9/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/belio/KPlCfFwC9xTyKoL9/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/belio/KPlCfFwC9xTyKoL9/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Circuit breaker - Belio Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"What Belio does when a delivery-receipt callback URL is unreachable.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Belio Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.belio.co.ke/callbacks/circuit-breaker\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://belio.mintlify.app/_mintlify/api/og/v2?division=Messaging\u0026amp;title=Circuit+breaker\u0026amp;description=What+Belio+does+when+a+delivery-receipt+callback+URL+is+unreachable.\u0026amp;theme=5c006f356a658d5c03852a02\u0026amp;signature=6da1854439a9b29f80d644e13ede0d5f79aa8a93df7dfff81f5567f399d886fa\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Circuit breaker - Belio Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"What Belio does when a delivery-receipt callback URL is unreachable.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://belio.mintlify.app/_mintlify/api/og/v2?division=Messaging\u0026amp;title=Circuit+breaker\u0026amp;description=What+Belio+does+when+a+delivery-receipt+callback+URL+is+unreachable.\u0026amp;theme=5c006f356a658d5c03852a02\u0026amp;signature=6da1854439a9b29f80d644e13ede0d5f79aa8a93df7dfff81f5567f399d886fa\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/belio/KPlCfFwC9xTyKoL9/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Belio Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#16A34A\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.belio.co.ke/callbacks/circuit-breaker\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/callbacks/circuit-breaker.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.belio.co.ke/#organization\",\"name\":\"Belio Docs\",\"url\":\"https://docs.belio.co.ke\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/belio/PDVtnSHUd86QGkzM/logo/light.svg?fit=max\u0026auto=format\u0026n=PDVtnSHUd86QGkzM\u0026q=85\u0026s=b31e8e7e998cd24f1336028d5f506e5f\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.belio.co.ke#website\",\"name\":\"Belio Docs\",\"url\":\"https://docs.belio.co.ke\",\"publisher\":{\"@id\":\"https://docs.belio.co.ke/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.belio.co.ke/callbacks/circuit-breaker#webpage\",\"url\":\"https://docs.belio.co.ke/callbacks/circuit-breaker\",\"name\":\"Circuit breaker\",\"description\":\"What Belio does when a delivery-receipt callback URL is unreachable.\",\"dateModified\":\"2026-10-30T15:41:16.081Z\",\"isPartOf\":{\"@id\":\"https://docs.belio.co.ke#website\"},\"breadcrumb\":{\"@id\":\"https://docs.belio.co.ke/callbacks/circuit-breaker#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.belio.co.ke/callbacks/circuit-breaker#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Messaging\",\"item\":\"https://docs.belio.co.ke/messaging/introduction\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Circuit breaker\",\"item\":\"https://docs.belio.co.ke/callbacks/circuit-breaker\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.belio.co.ke/callbacks/circuit-breaker#article\",\"headline\":\"Circuit breaker\",\"name\":\"Circuit breaker\",\"description\":\"What Belio does when a delivery-receipt callback URL is unreachable.\",\"url\":\"https://docs.belio.co.ke/callbacks/circuit-breaker\",\"mainEntityOfPage\":{\"@id\":\"https://docs.belio.co.ke/callbacks/circuit-breaker#webpage\"},\"dateModified\":\"2026-10-30T15:41:16.081Z\",\"publisher\":{\"@id\":\"https://docs.belio.co.ke/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.belio.co.ke#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Belio Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Belio Docs","nav":{"global":{"anchors":[{"anchor":"Website","icon":"link","href":"https://belio.co.ke"}]},"tabs":[{"tab":"REST API","groups":[{"group":"REST API","pages":[{"title":"Overview","icon":"webhook","href":"/overview"}]},{"group":"Authentication","pages":[{"title":"Introduction","href":"/authentication/introduction"},{"title":"Bearer Token","openapi":"POST /realms/api/protocol/openid-connect/token","href":"/authentication/bearer-token"}]},{"group":"Services","pages":[{"title":"List Services","openapi":"GET /service","href":"/service/list"}]},{"group":"Messaging","pages":[{"title":"Introduction","href":"/messaging/introduction"},{"group":"SMS","pages":[{"title":"Introduction","href":"/messaging/sms/introduction"},{"group":"Templates","pages":[{"title":null,"href":"/messaging/sms/templates/introduction"},{"title":"Template Parameters","href":"/messaging/sms/templates/parameters"},{"title":"Create Template","href":"/messaging/sms/templates/create-template"},{"title":"View Templates","href":"/messaging/sms/templates/view-templates"},{"title":"List templates","href":"/messaging/sms/templates/list-templates"}]},{"title":"Send Message","openapi":"POST /message/{serviceId}","href":"/messaging/sms/send"},{"title":"Delivery Receipts","href":"/messaging/sms/delivery-receipt"}]},{"group":"WhatsApp","tag":"BETA","pages":[{"title":null,"href":"/messaging/whatsapp/introduction"},{"title":"Pricing","href":"/messaging/whatsapp/pricing"},{"group":"Templates","pages":[{"title":null,"href":"/messaging/whatsapp/templates/introduction"},{"title":"Create Template","href":"/messaging/whatsapp/templates/create-template"},{"title":"View Templates","href":"/messaging/whatsapp/templates/view-templates"}]},{"title":"Send Message","openapi":"POST /message/{serviceId}/whatsapp","href":"/messaging/whatsapp/send"},{"title":"Delivery Receipts","href":"/messaging/whatsapp/delivery-receipt"}]},{"title":"Callback security","description":"HMAC signing and IP whitelisting for delivery-receipt callbacks.","href":"/callbacks/security"},{"title":"Circuit breaker","href":"/callbacks/circuit-breaker"}]},{"group":"USSD","pages":[{"title":"Introduction","description":null,"href":"/ussd/introduction"},{"title":"Session Flow","href":"/ussd/session-flow"},{"title":"Callback security","href":"/ussd/callback-security"},{"title":"Belio Eats Demo","href":"/ussd/belio-eats"}]},{"group":"Mobile Data","tag":"NEW","pages":[{"title":"Introduction","href":"/mobile-data/introduction"},{"title":"Disburse Data","openapi":"POST /data/{campaignId}","href":"/mobile-data/send"},{"title":"Delivery Receipts","href":"/mobile-data/delivery-receipt"}]},{"group":"Bundles","pages":[{"title":"List Bundles","openapi":"GET /bundle/{productType}","href":"/bundle/list"}]},{"group":"Campaigns","pages":[{"title":"List Campaigns","openapi":"GET /data/campaign","href":"/campaign/list"}]}]}]},"title":"Circuit breaker - Belio Docs","buildId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","deploymentId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","dynamics":[],"chunks":[]}