While Convoy guarantees you’ll be able to receive events as fast as possible, your customers might not be able to handle events arriving at the same rate, which could disrupt service on their end. You can control the number of events you send to an endpoint by setting a rate limit and a rate-limit duration on each endpoint. The default is 5000 in 1m — i.e. 5,000 requests per minute.See Rate limits in the Product Manual for configuration details.
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Convoy","colors":{"primary":"#2780F1","light":"#739FEA","dark":"#477BD3"},"logo":{"light":"https://mintcdn.com/convoy/ZDnFuM112cm76jYI/logo/light.svg?fit=max\u0026auto=format\u0026n=ZDnFuM112cm76jYI\u0026q=85\u0026s=3d933080cf301678d7fafe5f50d4ec12","dark":"https://mintcdn.com/convoy/vmJyPsa9GtTKdw-a/logo/dark.svg?fit=max\u0026auto=format\u0026n=vmJyPsa9GtTKdw-a\u0026q=85\u0026s=7d0ea6ef778d7ed00854dc455e9b12ea"},"favicon":"https://mintcdn.com/convoy/Ckv6F6QCAG1QB-UF/favicon.png?fit=max\u0026auto=format\u0026n=Ckv6F6QCAG1QB-UF\u0026q=85\u0026s=cc975351cd155c7828899933dca4f999","background":{"image":"https://mintcdn.com/convoy/Ckv6F6QCAG1QB-UF/background.png?fit=max\u0026auto=format\u0026n=Ckv6F6QCAG1QB-UF\u0026q=85\u0026s=165fcf2460dff22b7e1c8d84d0741646"},"navbar":{"primary":{"type":"github","label":"GitHub","href":"https://github.com/frain-dev/convoy"}},"footer":{"socials":{"twitter":"https://twitter.com/getconvoy?lang=en","linkedin":"https://www.linkedin.com/company/convoy-webhooks"}},"seo":{"metatags":{"canonical":"https://www.getconvoy.io/docs"}},"integrations":{"posthog":{"apiKey":"phc_X7uV1sRNzjoTmWp8uXYrzrfrdUtGdMRTEEklRNt04eb","apiHost":"https://us.i.posthog.com"}},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"Community","icon":"slack","href":"https://convoy-community.slack.com/join/shared_invite/zt-xiuuoj0m-yPp~ylfYMCV9s038QL0IUQ#/shared-invite/email"},{"anchor":"GitHub","icon":"github","href":"https://github.com/frain-dev/convoy"},{"anchor":"Status","icon":"signal","href":"https://status.getconvoy.io"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"convoy","hasAudioNarration":false,"actualSubdomain":"convoy","customDomains":["getconvoy.io"],"gitSource":{"type":"github","owner":"frain-dev","repo":"convoy-website","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae50032dbe71608b89029e5","collectionId":"118644cb-011e-4922-8a20-f36a66055bb0","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae50032dbe71608b89029e5"},"feedback":{"thumbs":true,"edits":false,"issues":false},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ae50032dbe71608b89029e5","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"default","tag":"API Reference","count":70},{"language":"default","tag":"Documentation","count":68},{"language":"default","tag":"Product Manual","count":28},{"language":"default","tag":"Glossary","count":13},{"language":"default","tag":"Endpoints","count":9},{"language":"default","tag":"Events","count":8},{"language":"default","tag":"Subscription Filters","count":8},{"language":"default","tag":"Deployment","count":8},{"language":"default","tag":"Subscriptions","count":7},{"language":"default","tag":"Portal Links","count":6}]},"assistantConfig":{},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"glossary/rate-limiting-endpoints","slug":"/glossary/rate-limiting-endpoints","pageMetadata":{"title":"Rate Limiting Endpoints","description":"Control how fast events are sent to an endpoint.","href":"/glossary/rate-limiting-endpoints"},"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: \"Control how fast events are sent to an endpoint.\"\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`,code:`code`,p:`p`,..._provideComponents(),...props.components};return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`While Convoy guarantees you’ll be able to receive events as fast as possible, your customers might not be able to handle events arriving at the same rate, which could disrupt service on their end. You can control the number of events you send to an endpoint by setting a rate limit and a rate-limit duration on each endpoint. The default is `,_jsx(_components.code,{children:`5000`}),` in `,_jsx(_components.code,{children:`1m`}),` — i.e. 5,000 requests per minute.`]}),`\n`,_jsxs(_components.p,{children:[`See `,_jsx(_components.a,{href:`/product-manual/rate-limits`,children:`Rate limits`}),` in the Product Manual for configuration details.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Rate Limiting Endpoints","description":"Control how fast events are sent to an endpoint.","href":"/glossary/rate-limiting-endpoints"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"subdomain":"convoy","siteName":"Convoy","title":"Rate Limiting Endpoints - Convoy","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-06-23T12:55:15.958Z","originalFileLocation":"glossary/rate-limiting-endpoints.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=\"Control how fast events are sent to an endpoint.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Convoy\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/convoy/kEzgHUgYWKvNq-_s/_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=\"/docs/mintlify-assets/_mintlify/favicons/convoy/kEzgHUgYWKvNq-_s/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/convoy/kEzgHUgYWKvNq-_s/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/convoy/kEzgHUgYWKvNq-_s/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/convoy/kEzgHUgYWKvNq-_s/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/convoy/kEzgHUgYWKvNq-_s/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/convoy/kEzgHUgYWKvNq-_s/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/convoy/kEzgHUgYWKvNq-_s/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/convoy/kEzgHUgYWKvNq-_s/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Rate Limiting Endpoints - Convoy\">\u003cmeta data-mint-head property=\"og:description\" content=\"Control how fast events are sent to an endpoint.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Convoy\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://www.getconvoy.io/docs/glossary/rate-limiting-endpoints\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://convoy.mintlify.app/_mintlify/api/og/v2?division=Glossary\u0026amp;title=Rate+Limiting+Endpoints\u0026amp;description=Control+how+fast+events+are+sent+to+an+endpoint.\u0026amp;theme=c3e2637d3c607fb0b7840509\u0026amp;signature=51e591d22366b3be06a1c4b36b5819a769ff756654e245058450c66f42172711\">\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=\"Rate Limiting Endpoints - Convoy\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Control how fast events are sent to an endpoint.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://convoy.mintlify.app/_mintlify/api/og/v2?division=Glossary\u0026amp;title=Rate+Limiting+Endpoints\u0026amp;description=Control+how+fast+events+are+sent+to+an+endpoint.\u0026amp;theme=c3e2637d3c607fb0b7840509\u0026amp;signature=51e591d22366b3be06a1c4b36b5819a769ff756654e245058450c66f42172711\">\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=\"/docs/mintlify-assets/_mintlify/favicons/convoy/kEzgHUgYWKvNq-_s/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Convoy\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2780F1\">\u003clink data-mint-head rel=\"canonical\" href=\"https://www.getconvoy.io/docs/glossary/rate-limiting-endpoints\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/glossary/rate-limiting-endpoints.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://www.getconvoy.io/#organization\",\"name\":\"Convoy\",\"url\":\"https://www.getconvoy.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/convoy/ZDnFuM112cm76jYI/logo/light.svg?fit=max\u0026auto=format\u0026n=ZDnFuM112cm76jYI\u0026q=85\u0026s=3d933080cf301678d7fafe5f50d4ec12\"}},{\"@type\":\"WebSite\",\"@id\":\"https://www.getconvoy.io/docs#website\",\"name\":\"Convoy\",\"url\":\"https://www.getconvoy.io/docs\",\"publisher\":{\"@id\":\"https://www.getconvoy.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://www.getconvoy.io/docs/glossary/rate-limiting-endpoints#webpage\",\"url\":\"https://www.getconvoy.io/docs/glossary/rate-limiting-endpoints\",\"name\":\"Rate Limiting Endpoints\",\"description\":\"Control how fast events are sent to an endpoint.\",\"dateModified\":\"2026-06-23T12:55:15.958Z\",\"isPartOf\":{\"@id\":\"https://www.getconvoy.io/docs#website\"},\"breadcrumb\":{\"@id\":\"https://www.getconvoy.io/docs/glossary/rate-limiting-endpoints#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://www.getconvoy.io/docs/glossary/rate-limiting-endpoints#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Glossary\",\"item\":\"https://www.getconvoy.io/docs/glossary/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Rate Limiting Endpoints\",\"item\":\"https://www.getconvoy.io/docs/glossary/rate-limiting-endpoints\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://www.getconvoy.io/docs/glossary/rate-limiting-endpoints#article\",\"headline\":\"Rate Limiting Endpoints\",\"name\":\"Rate Limiting Endpoints\",\"description\":\"Control how fast events are sent to an endpoint.\",\"url\":\"https://www.getconvoy.io/docs/glossary/rate-limiting-endpoints\",\"mainEntityOfPage\":{\"@id\":\"https://www.getconvoy.io/docs/glossary/rate-limiting-endpoints#webpage\"},\"dateModified\":\"2026-06-23T12:55:15.958Z\",\"publisher\":{\"@id\":\"https://www.getconvoy.io/#organization\"},\"isPartOf\":{\"@id\":\"https://www.getconvoy.io/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Convoy\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Convoy","nav":{"global":{"anchors":[{"anchor":"Community","icon":"slack","href":"https://convoy-community.slack.com/join/shared_invite/zt-xiuuoj0m-yPp~ylfYMCV9s038QL0IUQ#/shared-invite/email"},{"anchor":"GitHub","icon":"github","href":"https://github.com/frain-dev/convoy"},{"anchor":"Status","icon":"signal","href":"https://status.getconvoy.io"}]},"tabs":[{"tab":"Documentation","groups":[{"group":"Home","pages":[{"title":"Quickstart","mode":"wide","href":"/home/quickstart"},{"title":"Introduction","href":"/home/introduction"}]},{"group":"Guides","pages":[{"title":"Send Your First Webhook Event","sidebarTitle":"Send Event","href":"/guides/sending-webhook-example"},{"title":"Receive Your First Webhook Event","sidebarTitle":"Receive Event","href":"/guides/receiving-webhook-example"},{"title":"Best practices for generating webhook events","sidebarTitle":"Best practices for generating webhook events","href":"/guides/best-practices-for-generating-webhook-events"},{"title":"API-driven onboarding","href":"/guides/api-onboarding"}]},{"group":"Deployment","pages":[{"title":"Architecture","href":"/deployment/architecture"},{"title":"Configuration","href":"/deployment/configuration"},{"title":"PostgreSQL \u0026 PGBouncer","sidebarTitle":"PostgreSQL \u0026 PGBouncer","href":"/deployment/postgres-and-pgbouncer"},{"title":"Redis \u0026 Redis Sentinel","sidebarTitle":"Redis \u0026 Redis Sentinel","href":"/deployment/redis-and-sentinel"},{"group":"Install Convoy","pages":[{"title":"Docker","href":"/deployment/install-convoy/docker"},{"title":"Kubernetes","href":"/deployment/install-convoy/kubernetes"},{"title":"AKS (Azure Kubernetes Service)","href":"/deployment/install-convoy/aks"},{"title":"Troubleshooting","href":"/deployment/install-convoy/troubleshooting"}]}]},{"group":"Product Manual","pages":[{"title":"Organizations and Projects","href":"/product-manual/organizations-and-projects"},{"title":"Role-Based Access Control (RBAC)","href":"/product-manual/rbac"},{"title":"Google Single Sign-On (SSO)","href":"/product-manual/google-sso"},{"title":"Endpoints","href":"/product-manual/endpoints"},{"title":"Endpoint verification and outbound connections","href":"/product-manual/endpoint-verification"},{"title":"Signatures","href":"/product-manual/signatures"},{"title":"Sources","href":"/product-manual/sources"},{"title":"Subscriptions","href":"/product-manual/subscriptions"},{"title":"Events and Event Deliveries","href":"/product-manual/events-and-event-deliveries"},{"title":"Portal Links","href":"/product-manual/portal-links"},{"title":"Meta Events","href":"/product-manual/meta-events"},{"title":"Idempotency","href":"/product-manual/idempotency"},{"title":"Webhooks Documentation","href":"/product-manual/webhooks-documentation"},{"group":"Forward Proxies","pages":[{"title":null,"href":"/product-manual/forward-proxies/nginx"},{"title":null,"href":"/product-manual/forward-proxies/smokescreen"}]},{"group":"Message Brokers","pages":[{"title":"Apache Kafka","href":"/product-manual/message-brokers/kafka"},{"title":"Amazon SQS","href":"/product-manual/message-brokers/sqs"},{"title":"Google PubSub","href":"/product-manual/message-brokers/pub-sub"},{"title":"RabbitMQ","href":"/product-manual/message-brokers/rabbitmq"}]},{"title":"Rate Limits","href":"/product-manual/rate-limits"},{"title":"Filters","href":"/product-manual/filters"},{"title":"Functions","href":"/product-manual/functions"},{"title":"Metrics","href":"/product-manual/metrics"},{"title":"Read Replicas","href":"/product-manual/read-replicas"},{"title":"Circuit Breaker","href":"/product-manual/circuit-breaker"},{"title":"Postgres Queue","href":"/product-manual/postgres-queue"},{"title":"Retention Policy","href":"/product-manual/retention-policy"},{"title":"Custom Certificate Authority","href":"/product-manual/custom-certificate-authority"}]},{"group":"Command Line","pages":[{"title":"CLI","sidebarTitle":"Convoy","href":"/cli-file/convoy"},{"title":"Convoy CLI","href":"/cli-file/convoy-cli"}]},{"group":"SDK","pages":[{"title":"SDK","sidebarTitle":"Overview","href":"/sdk/sdk"}]},{"group":"Cloud","pages":[{"title":"Convoy Cloud Upgrade Policy","sidebarTitle":"Cloud Upgrade Policy","href":"/cloud/cloud-upgrade-policy"},{"title":"Convoy Cloud Subscription and Access Policy","sidebarTitle":"Convoy Cloud Subscription and Access Policy","href":"/cloud/cloud-subscription-policy"}]},{"group":"Legal","pages":[{"title":"Support Policy","href":"/legal/support-policy"},{"title":"Software License Agreement","href":"/legal/software-license-agreement"}]},{"group":"Business \u0026 Enterprise","pages":[{"title":"Licensing","href":"/business-and-enterprise/licensing"},{"title":"Paid Features","href":"/business-and-enterprise/paid-features"},{"title":"Single Sign-On (SAML)","href":"/business-and-enterprise/single-sign-on"}]},{"group":"Glossary","pages":[{"title":"Glossary","href":"/glossary/overview"},{"title":"Projects","href":"/glossary/projects"},{"title":"Endpoints","href":"/glossary/endpoints"},{"title":"Events","href":"/glossary/events"},{"title":"Event delivery","href":"/glossary/event-delivery"},{"title":"Event Types","href":"/glossary/event-types"},{"title":"Delivery Attempts","href":"/glossary/delivery-attempts"},{"title":"Dead Endpoints","href":"/glossary/dead-endpoints"},{"title":"Secrets","href":"/glossary/secrets"},{"title":"Hash Functions","href":"/glossary/hash-functions"},{"title":"Replay Attacks","description":"How Convoy helps prevent fraudulent re-transmission of payloads.","href":"/glossary/replay-attacks"},{"title":"Rate Limiting Endpoints","href":"/glossary/rate-limiting-endpoints"},{"title":"Retry Schedule","description":"How and when Convoy retries failed deliveries.","href":"/glossary/retry-schedule"}]},{"group":"Resources","pages":[{"title":"Telemetry","href":"/resources/telemetry"},{"title":"Feature Flags","href":"/resources/feature-flags"}]},{"group":"FAQ","pages":[{"title":"FAQ","sidebarTitle":"Overview","href":"/faq/faq"}]}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/welcome"}]},{"tab":"Webhook Guides","pages":[{"title":"Webhook Guides","href":"/webhook-guides/webhook-retries"}]}]},"basePath":"","title":"Rate Limiting Endpoints - Convoy","buildId":"dpl_6cCEiK8XNNvaLBBkWzcBhdE9QfLC","deploymentId":"dpl_6cCEiK8XNNvaLBBkWzcBhdE9QfLC","dynamics":[],"chunks":[]}