If your webhook endpoint does not respond with a success status code (2XX), we retry the request to ensure every message will be delivered. You can see all the retry attempts in your webhook event logs.Webhooks are retried until they are successfully delivered – with an exponential backoff to avoid overwhelming your webhook endpoint (also known as the “thundering herd problem”). The delay is capped at 5th retry attempt.
Retry attempt
Delay
1st
0s
2nd
2s
3rd
4s
4th
8s
5th
16s
{"docsConfig":{"$schema":"https://mintlify.com/docs.json","theme":"mint","name":"Dock","colors":{"primary":"#4058FF","light":"#4984EB","dark":"#4058FF"},"favicon":"https://mintcdn.com/docklabsinc/pUYB1Rr4_wf6-EkO/favicon.svg?fit=max\u0026auto=format\u0026n=pUYB1Rr4_wf6-EkO\u0026q=85\u0026s=3834c2cccaa90659d26b91bd3aec0acf","logo":{"light":"https://mintcdn.com/docklabsinc/pUYB1Rr4_wf6-EkO/logo/light.svg?fit=max\u0026auto=format\u0026n=pUYB1Rr4_wf6-EkO\u0026q=85\u0026s=8d3b9704bcec3086906fe18017582e75","dark":"https://mintcdn.com/docklabsinc/pUYB1Rr4_wf6-EkO/logo/dark.svg?fit=max\u0026auto=format\u0026n=pUYB1Rr4_wf6-EkO\u0026q=85\u0026s=8b39fd5e516073e4e2b131c298a28cc0"},"api":{"openapi":"api-reference/openapi.json"},"background":{"decoration":"gradient"},"footer":{"socials":{"x":"https://x.com/dock_us","linkedin":"https://www.linkedin.com/company/dock-us"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"docklabsinc","hasAudioNarration":false,"actualSubdomain":"docklabsinc","customDomains":["developers.dock.us"],"gitSource":{"type":"github","owner":"dock-hq","repo":"dock","deployBranch":"production","contentDirectory":"apps/docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6aea7f489a60fd4f65dac761","collectionId":"a9ae3e00-b569-4284-9508-eb12bdabf3bb","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6aea7f489a60fd4f65dac761"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6aeadc15826a3a87e614b864","clientVersion":"0.0.4067","searchFilterCounts":[{"language":"default","tag":"Documentation","count":88},{"language":"default","tag":"Workspaces","count":52},{"language":"default","tag":"Library","count":12},{"language":"default","tag":"Webhooks","count":12},{"language":"default","tag":"Clients","count":9},{"language":"default","tag":"Tasks","count":8},{"language":"default","tag":"Learning","count":7},{"language":"default","tag":"Users","count":7},{"language":"default","tag":"API Reference","count":6},{"language":"default","tag":"Assets","count":5}]},"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":"rbac-expansion","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":"full-page-search","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":"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":"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":"turbopuffer-dual-write","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},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"webhooks/retry-behaviour","slug":"/webhooks/retry-behaviour","pageMetadata":{"title":"Retry behaviour","og:title":"Dock Webhook Reference - Retry behaviour","description":"Retry behaviour for webhooks.","icon":"repeat","href":"/webhooks/retry-behaviour"},"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: \"Retry behaviour for webhooks.\"\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={a:`a`,p:`p`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{Heading,Table}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`retry-behaviour`,children:`Retry Behaviour`}),`\n`,_jsx(_components.p,{children:`If your webhook endpoint does not respond with a success status code (2XX), we retry the request to ensure every message will be delivered. You can see all the retry attempts in your webhook event logs.`}),`\n`,_jsxs(_components.p,{children:[`Webhooks are retried until they are successfully delivered – with an exponential backoff to avoid overwhelming your webhook endpoint (also known as the “`,_jsx(_components.a,{href:`https://en.wikipedia.org/wiki/Thundering_herd_problem`,children:`thundering herd problem`}),`”). The delay is capped at 5th retry attempt.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Retry attempt`}),_jsx(_components.th,{children:`Delay`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`1st`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`0s`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`2nd`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`2s`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`3rd`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`4s`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`4th`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`8s`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`5th`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`16s`})]})]})]})]})}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 behaviour","og:title":"Dock Webhook Reference - Retry behaviour","description":"Retry behaviour for webhooks.","icon":"repeat","href":"/webhooks/retry-behaviour"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Retry Behaviour","slug":"retry-behaviour","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"docklabsinc","siteName":"Dock","title":"Dock Webhook Reference - Retry behaviour","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-01-07T04:01:16.540Z","originalFileLocation":"webhooks/retry-behaviour.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=\"Retry behaviour for webhooks.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Dock\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/docklabsinc/3Zgmq5f-wF0-SYL9/_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/docklabsinc/3Zgmq5f-wF0-SYL9/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/docklabsinc/3Zgmq5f-wF0-SYL9/_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/docklabsinc/3Zgmq5f-wF0-SYL9/_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/docklabsinc/3Zgmq5f-wF0-SYL9/_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/docklabsinc/3Zgmq5f-wF0-SYL9/_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/docklabsinc/3Zgmq5f-wF0-SYL9/_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/docklabsinc/3Zgmq5f-wF0-SYL9/_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/docklabsinc/3Zgmq5f-wF0-SYL9/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Dock Webhook Reference - Retry behaviour\">\u003cmeta data-mint-head property=\"og:description\" content=\"Retry behaviour for webhooks.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Dock\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developers.dock.us/webhooks/retry-behaviour\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://docklabsinc.mintlify.app/_mintlify/api/og/v2?division=Webhooks\u0026amp;title=Retry+behaviour\u0026amp;description=Retry+behaviour+for+webhooks.\u0026amp;theme=98ee7d80663d009b7feb29d2\u0026amp;signature=d0530f577a71e70be2be978308d501fe92f2704a4edfae3696526772488bd993\">\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=\"Dock Webhook Reference - Retry behaviour\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Retry behaviour for webhooks.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://docklabsinc.mintlify.app/_mintlify/api/og/v2?division=Webhooks\u0026amp;title=Retry+behaviour\u0026amp;description=Retry+behaviour+for+webhooks.\u0026amp;theme=98ee7d80663d009b7feb29d2\u0026amp;signature=d0530f577a71e70be2be978308d501fe92f2704a4edfae3696526772488bd993\">\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/docklabsinc/3Zgmq5f-wF0-SYL9/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Dock\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#4058FF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developers.dock.us/webhooks/retry-behaviour\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/webhooks/retry-behaviour.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developers.dock.us/#organization\",\"name\":\"Dock\",\"url\":\"https://developers.dock.us\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/docklabsinc/pUYB1Rr4_wf6-EkO/logo/light.svg?fit=max\u0026auto=format\u0026n=pUYB1Rr4_wf6-EkO\u0026q=85\u0026s=8d3b9704bcec3086906fe18017582e75\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developers.dock.us#website\",\"name\":\"Dock\",\"url\":\"https://developers.dock.us\",\"publisher\":{\"@id\":\"https://developers.dock.us/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developers.dock.us/webhooks/retry-behaviour#webpage\",\"url\":\"https://developers.dock.us/webhooks/retry-behaviour\",\"name\":\"Retry behaviour\",\"description\":\"Retry behaviour for webhooks.\",\"dateModified\":\"2026-01-07T04:01:16.540Z\",\"isPartOf\":{\"@id\":\"https://developers.dock.us#website\"},\"breadcrumb\":{\"@id\":\"https://developers.dock.us/webhooks/retry-behaviour#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developers.dock.us/webhooks/retry-behaviour#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Webhooks\",\"item\":\"https://developers.dock.us/webhooks/introduction\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Retry behaviour\",\"item\":\"https://developers.dock.us/webhooks/retry-behaviour\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://developers.dock.us/webhooks/retry-behaviour#article\",\"headline\":\"Retry behaviour\",\"name\":\"Retry behaviour\",\"description\":\"Retry behaviour for webhooks.\",\"url\":\"https://developers.dock.us/webhooks/retry-behaviour\",\"mainEntityOfPage\":{\"@id\":\"https://developers.dock.us/webhooks/retry-behaviour#webpage\"},\"dateModified\":\"2026-01-07T04:01:16.540Z\",\"publisher\":{\"@id\":\"https://developers.dock.us/#organization\"},\"isPartOf\":{\"@id\":\"https://developers.dock.us#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Dock\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Dock","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"Webhooks","groups":[{"group":"Webhooks","pages":[{"title":"Introduction","icon":"webhook","href":"/webhooks/introduction"},{"title":"Create a subscription","icon":"link-simple","href":"/webhooks/create-subscription"},{"title":"Send test events","description":"Send test events to your webhook URL to ensure that it's working correctly.","icon":"vial-circle-check","href":"/webhooks/test-event"},{"title":"Retry behaviour","icon":"repeat","href":"/webhooks/retry-behaviour"},{"title":"Verify webhook requests","description":"Learn how to verify webhook requests to ensure they're coming from Dock.","icon":"cloud-check","href":"/webhooks/verify-webhook-requests"},{"title":"Event types","icon":"rectangle-vertical-history","href":"/webhooks/event-types"}]}]}]},"basePath":"","title":"Dock Webhook Reference - Retry behaviour","buildId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","deploymentId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","dynamics":[],"chunks":[]}