Your client should respond as quickly as possible with an OK 200 HTTP status code. Any other response will result in our system marking the event as failed delivery.
Response times longer than 2000ms may result in a failed delivery.
In case of no response or a response different than OK 200 HTTP status code from your client, our platform will make additional attempts to redeliver the event:
Initial attempt: The platform will try to deliver the message 5 times with a timeout set to 5 seconds for each attempt
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Fourthwall Developer Docs","colors":{"primary":"#000000","light":"#4D4D4D","dark":"#000000"},"logo":{"light":"https://mintcdn.com/fourthwall/ll6NfYA7kbBxufP4/logo/light.svg?fit=max\u0026auto=format\u0026n=ll6NfYA7kbBxufP4\u0026q=85\u0026s=44d55b19c2c524eb8e4ee5a9de5c89e7","dark":"https://mintcdn.com/fourthwall/ll6NfYA7kbBxufP4/logo/dark.svg?fit=max\u0026auto=format\u0026n=ll6NfYA7kbBxufP4\u0026q=85\u0026s=6e05cd1920c11af37f6a6c8f6a894ab6"},"favicon":"https://mintcdn.com/fourthwall/ll6NfYA7kbBxufP4/favicon.svg?fit=max\u0026auto=format\u0026n=ll6NfYA7kbBxufP4\u0026q=85\u0026s=fe14d6128c59ded57a36fe3a5170ffed","api":{"playground":{},"examples":{"prefill":true}},"navbar":{"links":[{"href":"mailto:support@fourthwall.com","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://my-shop.fourthwall.com/admin/dashboard?redirect"}},"footer":{"socials":{"x":"https://x.com/fourthwall","github":"https://github.com/FourthwallHQ","discord":"https://discord.com/invite/kc6P68z3Uz"}},"integrations":{"gtm":{"tagId":"GTM-W4JTQQ9"}},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Fourthwall","icon":"globe","href":"https://fourthwall.com"},{"anchor":"Discord","icon":"discord","href":"https://discord.com/invite/kc6P68z3Uz"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"fourthwall","hasAudioNarration":false,"actualSubdomain":"fourthwall","customDomains":["docs.fourthwall.com"],"gitSource":{"type":"github","owner":"fourthwallhq","repo":"fourthwall-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae9baadeceed668c0260955","collectionId":"36bbe3fd-d3ea-41a2-9766-5f3e63de3bd8","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae9baadeceed668c0260955"},"entitlements":{},"buildId":"6ae9baadeceed668c0260955","clientVersion":"0.0.4076","searchFilterCounts":[{"language":"default","tag":"Platform API","count":79},{"language":"default","tag":"Guides","count":57},{"language":"default","tag":"Memberships API","count":34},{"language":"default","tag":"Webhook Events","count":21},{"language":"default","tag":"Webhooks","count":16},{"language":"default","tag":"Posts","count":15},{"language":"default","tag":"HTML Sections","count":14},{"language":"default","tag":"Channel API","count":10},{"language":"default","tag":"Collections","count":10},{"language":"default","tag":"Products","count":10}]},"assistantConfig":{"enableStarterQuestions":false},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"webhooks/retry-policies","slug":"/webhooks/retry-policies","pageMetadata":{"title":"Retry Policies","description":"Webhook delivery guarantees, retry logic, and timeout handling","href":"/webhooks/retry-policies"},"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: \"Webhook delivery guarantees, retry logic, and timeout handling\"\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`,li:`li`,p:`p`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Heading,Warning}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`response-policy`,children:`Response policy`}),`\n`,_jsxs(_components.p,{children:[`Your client should respond as quickly as possible with an `,_jsx(_components.code,{children:`OK 200 HTTP`}),` status code. Any other response will result in our system marking the event as failed delivery.`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Response times longer than `,_jsx(_components.strong,{children:`2000ms`}),` may result in a failed delivery.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`retry-policy`,children:`Retry policy`}),`\n`,_jsx(_components.p,{children:`In case of no response or a response different than OK 200 HTTP status code from your client, our platform will make additional attempts to redeliver the event:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Initial attempt`}),`: The platform will try to deliver the message 5 times with a timeout set to 5 seconds for each attempt`]}),`\n`]})]})}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":"Retry Policies","description":"Webhook delivery guarantees, retry logic, and timeout handling","href":"/webhooks/retry-policies"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Response policy","slug":"response-policy","depth":2,"children":[]},{"title":"Retry policy","slug":"retry-policy","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"fourthwall","siteName":"Fourthwall Developer Docs","title":"Retry Policies - Fourthwall Developer Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-01-27T21:57:54.499Z","originalFileLocation":"webhooks/retry-policies.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=\"Webhook delivery guarantees, retry logic, and timeout handling\">\u003cmeta data-mint-head name=\"application-name\" content=\"Fourthwall Developer 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/fourthwall/t-Pr9lNT9Pm8i5rs/_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/fourthwall/t-Pr9lNT9Pm8i5rs/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/fourthwall/t-Pr9lNT9Pm8i5rs/_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/fourthwall/t-Pr9lNT9Pm8i5rs/_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/fourthwall/t-Pr9lNT9Pm8i5rs/_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/fourthwall/t-Pr9lNT9Pm8i5rs/_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/fourthwall/t-Pr9lNT9Pm8i5rs/_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/fourthwall/t-Pr9lNT9Pm8i5rs/_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/fourthwall/t-Pr9lNT9Pm8i5rs/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Retry Policies - Fourthwall Developer Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Webhook delivery guarantees, retry logic, and timeout handling\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Fourthwall Developer Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.fourthwall.com/webhooks/retry-policies\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://fourthwall.mintlify.site/_mintlify/api/og/v2?division=Webhooks\u0026amp;title=Retry+Policies\u0026amp;description=Webhook+delivery+guarantees%2C+retry+logic%2C+and+timeout+handling\u0026amp;theme=d10057e5a1248fc4c9670d48\u0026amp;signature=dfd7b2121513e3a9f52ba4ce075e03ea3c3761d6d4e369a9867cae1705a3f161\">\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=\"Retry Policies - Fourthwall Developer Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Webhook delivery guarantees, retry logic, and timeout handling\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://fourthwall.mintlify.site/_mintlify/api/og/v2?division=Webhooks\u0026amp;title=Retry+Policies\u0026amp;description=Webhook+delivery+guarantees%2C+retry+logic%2C+and+timeout+handling\u0026amp;theme=d10057e5a1248fc4c9670d48\u0026amp;signature=dfd7b2121513e3a9f52ba4ce075e03ea3c3761d6d4e369a9867cae1705a3f161\">\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/fourthwall/t-Pr9lNT9Pm8i5rs/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Fourthwall Developer Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#000000\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.fourthwall.com/webhooks/retry-policies\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/webhooks/retry-policies.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.fourthwall.com/#organization\",\"name\":\"Fourthwall Developer Docs\",\"url\":\"https://docs.fourthwall.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/fourthwall/ll6NfYA7kbBxufP4/logo/light.svg?fit=max\u0026auto=format\u0026n=ll6NfYA7kbBxufP4\u0026q=85\u0026s=44d55b19c2c524eb8e4ee5a9de5c89e7\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.fourthwall.com#website\",\"name\":\"Fourthwall Developer Docs\",\"url\":\"https://docs.fourthwall.com\",\"publisher\":{\"@id\":\"https://docs.fourthwall.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.fourthwall.com/webhooks/retry-policies#webpage\",\"url\":\"https://docs.fourthwall.com/webhooks/retry-policies\",\"name\":\"Retry Policies\",\"description\":\"Webhook delivery guarantees, retry logic, and timeout handling\",\"dateModified\":\"2026-01-27T21:57:54.499Z\",\"isPartOf\":{\"@id\":\"https://docs.fourthwall.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.fourthwall.com/webhooks/retry-policies#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.fourthwall.com/webhooks/retry-policies#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Webhooks\",\"item\":\"https://docs.fourthwall.com/webhooks/getting-started\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Retry Policies\",\"item\":\"https://docs.fourthwall.com/webhooks/retry-policies\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.fourthwall.com/webhooks/retry-policies#article\",\"headline\":\"Retry Policies\",\"name\":\"Retry Policies\",\"description\":\"Webhook delivery guarantees, retry logic, and timeout handling\",\"url\":\"https://docs.fourthwall.com/webhooks/retry-policies\",\"mainEntityOfPage\":{\"@id\":\"https://docs.fourthwall.com/webhooks/retry-policies#webpage\"},\"dateModified\":\"2026-01-27T21:57:54.499Z\",\"publisher\":{\"@id\":\"https://docs.fourthwall.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.fourthwall.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Fourthwall Developer Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Fourthwall Developer Docs","nav":{"global":{"anchors":[{"anchor":"Fourthwall","icon":"globe","href":"https://fourthwall.com"},{"anchor":"Discord","icon":"discord","href":"https://discord.com/invite/kc6P68z3Uz"}]},"tabs":[{"tab":"Guides","groups":[{"group":"Getting Started","pages":[{"title":"Introduction","href":""}]},{"group":"API","pages":[{"title":"Platform API Overview","href":"/guides/overview"},{"title":"Quickstart","href":"/quickstart"},{"title":"Authentication","href":"/guides/authentication"},{"title":"Rate Limiting","href":"/guides/rate-limiting"}]},{"group":"Products","tag":"Beta","pages":[{"title":"Create digital products","href":"/guides/create-digital-products"},{"title":"Create design products","href":"/guides/create-design-products"}]},{"group":"Webhooks","pages":[{"title":"Getting Started with Webhooks","href":"/webhooks/getting-started"},{"title":"Managing Webhooks via API","href":"/webhooks/api-management"},{"title":"Webhook Model","href":"/webhooks/webhook-model"},{"title":"Webhook Event Types","href":"/webhooks/event-types"},{"title":"Signature Verification","href":"/webhooks/signature-verification"},{"title":"Testing Webhooks","description":"Test your webhook integration","href":"/webhooks/testing"},{"title":"Retry Policies","href":"/webhooks/retry-policies"},{"title":"Gifting Guide","description":"Handle gift purchase webhooks for Twitch gift redemptions","href":"/webhooks/gifting-guide"},{"title":"Limitations","href":"/webhooks/limitations"}]},{"group":"Streaming","pages":[{"title":"Alerts","href":"/streaming/alerts"}]},{"group":"Storefront","pages":[{"title":"Storefront API Overview","href":"/storefront/overview"},{"title":"Getting Started","href":"/storefront/getting-started"},{"title":"Fetching Products","href":"/storefront/products"},{"title":"Collection Handles","href":"/storefront/collection"},{"title":"Checkout Setup","href":"/storefront/checkout"},{"title":"Building a Cart \u0026 Checkout","href":"/storefront/cart-checkout-tutorial"},{"title":"Architecture","href":"/storefront/architecture"}]},{"group":"Shop APIs","pages":[{"title":"Cart Checkout Endpoint","href":"/shop-apis/cart-checkout-endpoint"},{"title":"Shop Feeds","href":"/shop-apis/shop-feeds"}]},{"group":"Apps","pages":[{"title":"Getting Started","href":"/apps/getting-started"},{"title":"OAuth Authentication","href":"/guides/oauth"},{"title":"App Sections","href":"/apps/app-sections"},{"title":"Embedded Settings","href":"/apps/embedded-settings"},{"title":"Publishing Your App","href":"/apps/publishing"}]},{"group":"Channel API","tag":"Beta","pages":[{"title":"Channel API Integration Guide","href":"/channel/integration-guide"},{"title":"Platform integration","href":"/channel-api/platform-integration"},{"title":"Agency integration","href":"/channel-api/agency-integration"}]},{"group":"Embedded Sections","pages":[{"title":"Embedded Sections","href":"/embedded-sections/overview"},{"title":"Messages","href":"/embedded-sections/messages"},{"title":"Signature Verification","href":"/embedded-sections/signature"}]},{"group":"HTML Sections","pages":[{"title":"Custom Code Sections","href":"/html/overview"},{"title":"Section Structure","href":"/html/section-structure"},{"group":"Objects","pages":[{"title":"Available Objects","href":"/html/objects/overview"},{"title":"collection","href":"/html/objects/collection"},{"title":"product","href":"/html/objects/product"},{"title":"membership_tiers","href":"/html/objects/membership-tiers"}]},{"group":"Filters","pages":[{"title":"Filters","href":"/html/filters/overview"},{"title":"Money Filters","href":"/html/filters/money"},{"title":"URL Filters","href":"/html/filters/url"},{"title":"Image Filters","href":"/html/filters/image"},{"title":"Array \u0026 String Filters","href":"/html/filters/array-string"},{"title":"Utility Filters","href":"/html/filters/utility"},{"title":"Standard Liquid Filters","href":"/html/filters/standard"}]},{"title":"Examples","href":"/html/examples"}]},{"group":"AI","pages":[{"title":"LLM Support","href":"/ai/llm-support"},{"title":"MCP Server","href":"/ai/mcp"},{"title":"ChatGPT \u0026 Claude App","href":"/ai/ai-app"}]},{"group":"Resources","pages":[{"title":"Changelog","href":"/guides/changelog"},{"title":"Community","href":"/resources/community"},{"title":"Storefront Showcase","href":"/resources/showcase"}]}]},{"tab":"Platform API","pages":[{"title":"Platform API","href":"/api-reference/platform/shop/get-current-shop"}]},{"tab":"Storefront API","pages":[{"title":"Storefront API","href":"/api-reference/storefront/shop/get-shop"}]},{"tab":"Memberships API","hidden":false,"pages":[{"title":"Memberships API","href":"/api-reference/membership/getting-started-images"}]},{"tab":"Channel API","pages":[{"title":"Channel API","href":"/channel-api/authentication"}]}]},"basePath":"","title":"Retry Policies - Fourthwall Developer Docs","buildId":"dpl_8LJbrAiZvr1K98WQNZXCyY5AvT34","deploymentId":"dpl_8LJbrAiZvr1K98WQNZXCyY5AvT34","dynamics":[],"chunks":[]}
