--- title: "API Rate Limits" slug: "api-rate-limits-1" description: "Reference for per-endpoint request limits on every Insider One API, including the 429 'Too Many Requests' error and how to handle it." updated: 2026-10-07T15:46:09Z published: 2026-10-07T15:46:09Z canonical: "academy.insiderone.com/api-rate-limits-1" --- > ## Documentation Index > Fetch the complete documentation index at: https://academy.insiderone.com/llms.txt > Use this file to discover all available pages before exploring further. # API Rate Limits A rate limit defines how many requests an API can handle within a specific time frame. In large systems, many denial-of-service issues happen unintentionally due to software bugs or misconfigurations rather than malicious intent. Rate limiting helps prevent these issues. Rate limits are applied per API key, though some limits apply per Insider One account. The table below notes when a limit is shared across an account or across endpoints. If you exceed the allowed number of requests within the set period, the API returns a **429** (Too Many Requests) response, also known as API throttling limits or request-per-second caps. When you receive a 429, back off and retry. When provided, the Retry-After response header (in seconds) may indicate how long to wait. Retrying with exponential backoff is recommended. For transactional send endpoints, a successful response means your request has been accepted and queued for delivery, but it does not confirm delivery. Actual delivery throughput depends on queue conditions, so accepted messages may be delivered shortly after acceptance, especially during large bursts. See below for the rate limits of [Insider One APIs](/v1/docs/insider-one-apis). | API | Endpoint | API Rate Limit | | --- | --- | --- | | **Unification APIs** - https://unification.useinsider.com/api/ | | [Upsert User Data](https://academy.useinsider.com/docs/upsert-user-data-api) | **/user/v1/upsert** | A total of **25,000** requests per minute, shared with the [Delete User Attribute](https://academy.insiderone.com/docs/delete-user-attribute-api), which means you can process up to **25 million** user records per minute with full batching. | | [Export Raw User Data](https://academy.insiderone.com/docs/export-raw-user-data-api) | **/raw/v1/export** | **1** request per day. Failed requests don't count. Based on the UTC time zone, the API can be called only once in 24 hours. The limitation timeline resets at UTC 00:00. | | [Delete User Attribute](https://academy.insiderone.com/docs/delete-user-attribute-api) | **/user/v1/attribute/delete** | A total of **25,000** requests per minute, shared with the [User Upsert API](https://academy.insiderone.com/docs/upsert-user-data-api). | | [Update Identifiers](https://academy.insiderone.com/docs/update-identifiers-api) | **/user/v1/identity** | **2000** requests per minute. | | [Delete Identifiers](https://academy.insiderone.com/docs/api-reference-delete-identifiers) | **/user/v1/identity** | **1,000** requests per minute. | | [Delete User Profiles](https://academy.insiderone.com/docs/delete-user-profile-api) | **/user/v1/delete** | **10,000** requests per minute. | | [Delete User’s PII Data](https://academy.insiderone.com/docs/delete-users-pii-data-api) | **/contact/v1/anonymize** **/user/v1/anonymize** | **500** requests per minute. | | **Contact APIs** - https://contact.useinsider.com/ | | [Upload First-Party Segments](https://academy.insiderone.com/docs/first-party-segments-api) | **/fps/v1/upload** | **100** requests per second with the same API Key. | | [Resubscribe Email Users V1](https://academy.insiderone.com/docs/resubscribe-email-users) | **/email/v1/subscribe** | **600** requests per minute with the same API Key. | | [Resubscribe SMS Users](https://academy.insiderone.com/docs/resubscribe-sms-users) | **/sms/v1/subscribe** | **600** requests per minute with the same API Key. | | [Resubscribe WhatsApp Users](https://academy.insiderone.com/docs/resubscribe-whatsapp-users) | **/whatsapp/v1/subscribe** | **600** requests per minute with the same API Key. | | **Web Push APIs** - https://web-push.api.useinsider.com/ | | [Create Single Web Pushes](https://academy.insiderone.com/docs/create-single-web-pushes) | **/v1/single** | **30** requests per minute. | | [Launch Single Web Pushes V1](https://academy.insiderone.com/docs/launch-single-web-pushes) | **/v1/single/campaign_id** | **30** requests per minute. | | [Launch Single Web Pushes V2](https://academy.insiderone.com/docs/launch-single-web-pushes-v2) | **/v2/single/campaign_id** | **6000** requests per minute. | | [Delete Single Web Pushes](https://academy.insiderone.com/docs/delete-single-web-pushes) | **/v1/single/campaign_id** | **30** requests per minute. | | [Get Web Push Top Metrics](https://academy.insiderone.com/docs/get-web-push-top-metrics-analytics-api) | **/v1/statistics/top-metrics** | **30** requests per minute in aggregate. | | [Get Web Push Overall Metrics](https://academy.insiderone.com/docs/get-web-push-overall-metrics-analytics-api) | **/v1/statistics/overall-metrics** | **30** requests per minute in aggregate. | | [Get Web Push Campaign Analytics](https://academy.insiderone.com/docs/get-web-push-campaign-metrics-analytics-api) | **/v1/statistics/campaign-metrics** | **30** requests per minute in aggregate. | | **Mail APIs** - https://mail.useinsider.com | | [Send Transactional Emails](https://academy.insiderone.com/docs/send-transactional-emails-api) | **/mail/v1/send** | **9000** requests per second. | | [Create Email Campaigns](https://academy.insiderone.com/docs/create-email-campaigns-api) | **/content/v1/campaign/create** | **1** request per second. | | [Template Migrator V1](https://academy.insiderone.com/docs/template-migrator-v1) | **/content/v1/template-migration/vendorname/extract-premigration-variables** | **60** requests per minute. | | [Template Migrator V2](https://academy.insiderone.com/docs/templates-migrator-v2) | **/content/v1/template-migration/{vendorname}/extract-premigration-variables** | **60** requests per minute. | | **Mobile APIs** - https://mobile.useinsider.com/ | | [Send Bulk App Pushes](https://academy.insiderone.com/docs/send-bulk-app-pushes-api) | **/api/v1/push/bulk** | **1000** requests per minute. | | [Send Targeted App Pushes](https://academy.insiderone.com/docs/send-targeted-app-pushes-api) | **/api/v2/notification/user** | **10000** requests per minute. | | [Send Advanced App Pushes](https://academy.insiderone.com/docs/send-advanced-app-pushes-api) | **/api/v2/notification/user** | **1000** requests per minute. | | [Send Basic Segment App Pushes](https://academy.insiderone.com/docs/send-basic-segment-app-pushes) | **/api/v1/push/bulk** | **1000** requests per minute. | | [Get Pushes with Message Center API](https://academy.insiderone.com/docs/get-pushes-with-message-center-api) | **/api/message_center/v1** | **5000** requests per minute. | | [Get InApp details](https://academy.insiderone.com/docs/get-inapp-details) | **/v1/details/inapp** | **1000** requests per minute. | | [Upload FCM Certificate API](https://academy.insiderone.com/docs/upload-fcm-certificate-api) | **/v1/settings/certificate/firebase** | **1000** requests per minute. | | **Verify APIs** - https://verify.useinsider.com/ | | [Create a Channel](https://academy.insiderone.com/docs/create-a-channel-whatsapp-otp) | **/v1/channel/create** | **25** requests per minute. | | [Create an OTP Template](https://academy.insiderone.com/docs/create-otp-template-whatsapp) | **/v1/template/create** | **25** requests per minute. | | [Update a Channel](https://academy.insiderone.com/docs/verify-api-update-a-channel) | **/v1/channel/update** | **25** requests per minute. | | [List OTP Templates](https://academy.insiderone.com/docs/list-otp-templates-whatsapp) | **/v1/template/list** | **25** requests per minute. | | [Update OTP Templates](https://academy.insiderone.com/docs/update-otp-templates-whatsapp) | **/v1/template/update** | **25** requests per minute. | | [Generate OTP Codes](https://academy.insiderone.com/docs/generate-otp-codes-whatsapp) | **/v1/generate** | **750** requests per minute. | | [Verify OTP Codes](https://academy.insiderone.com/docs/verify-otp-codes-whatsapp) | **/v1/check** | **750** requests per minute. | | **SMS APIs** - https://sms.useinsider.com/ | | [Send Transactional Single SMS](https://academy.insiderone.com/docs/send-transactional-single-sms) | **/v1/send** | **200** requests per second. | | [Send Transactional Bulk SMS](https://academy.insiderone.com/docs/send-transactional-bulk-sms) | **/v1/sendMultipleMessage** | **5** requests per second, and each request can include up to 50 messages, which means you can send up to 250 message parts per second. | | [Get SMS Campaign List](https://academy.insiderone.com/docs/get-sms-campaign-list) | **/analytics/v1/list** | **100** requests per minute with the same API Key. | | [Get SMS Campaign Analytics](https://academy.insiderone.com/docs/get-sms-campaign-analytics) | **/analytics/v1/campaign** | **100** requests per minute with the same API Key. | | [Get Overall SMS Campaign Analytics](https://academy.insiderone.com/docs/get-overall-sms-campaign-analytics) | **/analytics/v1/overall** | **100** requests per minute with the same API Key. | | [Get Transactional SMS Analytics](https://academy.useinsider.com/docs/get-transactional-sms-analytics) | **/analytics/v1/transactional** | **100** requests per minute with the same API Key. | | [Get OTP/Verify SMS Analytics](https://academy.insiderone.com/docs/get-otp-verify-sms-analytics) | **/analytics/v1/verify** | **100** requests per minute with the same API Key. | | **WhatsApp APIs** - https://whatsapp.useinsider.com/ | | [Transactional WhatsApp API](https://academy.insiderone.com/docs/whatsapp-transactional-api) | **/v1/send** | **1000** requests per second. | | [Conversational WhatsApp API](https://academy.insiderone.com/docs/whatsapp-conversational-api) | **/v1/conversational/send** | **1000** requests per second. | | **Analytics APIs** - https://analytics.api.useinsider.com | | [Get Email Campaign List V2](https://academy.insiderone.com/docs/get-email-campaign-list-v2) | **/email/v2/campaign/list** | **100** requests per minute with the same API Key. | | [Get Email Campaign Analytics V2](https://academy.insiderone.com/docs/get-email-analytics-v2) | **/email/v2/campaign/statistics** | **100** requests per minute with the same API Key. | | [Get Overall Email Analytics V2](https://academy.insiderone.com/docs/get-overall-email-analytics-v2) | **/email/v2/overall** | **100** requests per minute with the same API Key. | | [Get Overall Onsite Analytics](https://academy.insiderone.com/docs/get-overall-onsite-analytics-api) | **/onsite/v1/all** | **100** requests per minute with the same API Key. | | [Get Onsite Campaign Analytics](https://academy.insiderone.com/docs/get-onsite-campaign-analytics) | **/onsite/v1/campaign** | **100** requests per minute with the same API Key. | | [Changing Filter Values](https://academyinsiderone.com/docs/onsite-analytics-changing-filter-values) | **/onsite/v2/all** | **100** requests per minute with the same API Key. | | **Architect Analytics APIs** - https://architect-analytics.api.useinsider.com/ | | [Get Overall Architect Analytics](https://academy.insiderone.com/docs/get-architect-overall-analytics) | **/v1/overall** | **200** requests per minute with the same API Key. | | [Get Architect Journey Analytics](https://academy.insiderone.com/docs/get-architect-journey-analytics) | **/v1/journey/{journeyId}** | **200** requests per minute with the same API Key. | | [Get Architect Channel Analytics](https://academy.insiderone.com/docs/get-architect-channel-analytics) | **/v1/element/{campaignId}** | **200** requests per minute with the same API Key. | | [Export Journey List](https://academy.insiderone.com/docs/export-journey-list) | **/v1/journeys** | **200** requests per minute with the same API Key. | | [Get Conversion Goals Information](https://academy.insiderone.com/docs/get-conversion-goals-information) | **/v1/goals** | **200** requests per minute with the same API Key. | | **Catalog APIs** - https://catalog.api.useinsider.com/ | | [Ingest Product Information](https://academy.insiderone.com/docs/catalog-ingest-api) | **/v2/ingest** | **60** requests per minute, a combined limit for all endpoints of the Catalog API | | [Update Existing Product Information](https://academy.insiderone.com/docs/catalog-update-api) | **/v2/update** | **60** requests per minute, a combined limit for all endpoints of the Catalog API | | [Recommendation APIs](/v1/docs/recommendation-api) | **https://recommendation.api.useinsider.com/v2/{algorithm-name}** | **1000 calls** per minute, applied across all endpoints of the Recommendation API | | **Eureka APIs** | | [Search API](/v1/docs/eureka-search-api) | **https://ineureka.api.useinsider.com/api/web/search** | **350 requests** per second (RPS) per account-locale pair | | [Suggestion API](/v1/docs/eureka-suggestion-api) | **https://{domain_name}/api/web/suggestions/query** | **450 requests** per second (RPS) per account-locale pair | These notes apply to the following transactional send endpoints: Mail (/mail/v1/send), SMS (/v1/send, /v1/sendMultipleMessage), and WhatsApp (/v1/send): - The limits in the table are the **maximum request** rates the API accepts. They are not guaranteed delivery rates; accepted messages are queued and sent as delivery capacity allows. Higher limits can be configured on demand by contacting Insider One. - When a limit is exceeded, the API responds with **429** (Too Many Requests). Back off and retry. You can retry the request within the API's rate limit. - Access to a transactional API key can additionally be [restricted by IP](https://academy.insiderone.com/docs/security-principles-for-integrating-with-insider#panel-ip-restriction) on request. Contact the Insider One team to enable IP restriction. Transactional messaging is available for [email](/v1/docs/send-transactional-emails-api), [SMS](https://academy.insiderone.com/docs/transactional-sms-overview), and [WhatsApp](https://academy.insiderone.com/docs/whatsapp-transactional-api) send endpoints. Web push and app push are campaign or targeted-delivery channels and are not part of the transactional send APIs. **Rate limit vs. messaging throughput (MPS)** The limits in the table above cap **how many API requests** you can send to an endpoint per time window. They are separate from **Messaging Per Second (MPS),** which is the rate at which the platform actually delivers messages to the provider or carrier. A single request can carry multiple messages, so your effective send rate is governed by MPS, not only by the request limit. When you send faster than your MPS allows, messages are **queued and dispatched in the next interval rather than dropped**, and higher-priority traffic (automation and confirmation messages) is processed ahead of campaign traffic. For channel-specific throughput, queue ordering, and how to raise your limits, see: - [Messaging per Second (MPS) for SMS](/v1/docs/messaging-per-second-mps-for-sms) - [Messaging Per Second (MPS) for WhatsApp](/v1/docs/messaging-per-second-mps-for-whatsapp) - [Messaging Limits for WhatsApp](/v1/docs/messaging-limits-for-whatsapp)