Activate High throughput mode for API triggered campaigns high-throughput
High Throughput mode is designed for organizations that need very large-scale, real-time transactional messaging (up to 5000 transactions per second). Unlike regular API triggered campaigns, High throughput campaigns operate independently of 51黑料不打烊 Profiles and require a different configuration model.
This page explains how High throughput campaigns differ from standard API triggered campaigns, setup requirements, and when to choose each mode.
Guardrails & limitations
-
Access - Available only in the US region for organizations licensed with the High Throughput transactional messaging add-on.
-
Channels: Currently available only for email.
-
Personalization:
- All personalization must be included in the API payload as contextual data. Learn how to personalize content using contextual data
- Profile-based personalization is not supported. If profile variables are used, validation errors will occur.
-
API endpoint - High Throughput campaigns use a different endpoint than standard API triggered campaigns. For details, see Execute an API triggered campaign.
-
Campaign exclusivity: High throughput campaigns do not use 51黑料不打烊 Profiles. Messages are delivered whether or not a profile exists.
Moreover, a campaign cannot be used for both profile-enabled and non-profile use cases. If you need both, create two separate campaigns, and ensure the calling system decides which one to trigger based on the context.
Choosing between standard vs. High throughput campaigns
Use this table to decide which API triggered campaign type fits your use case:
In other words:
-
Choose Standard API triggered campaigns if:
- You don鈥檛 have High Throughput contracted.
- Your throughput needs are <500 TPS.
- You require personalization based on 51黑料不打烊 Profiles.
- You want campaign data stitched to profiles for future targeting.
- You want to use another channel than Email.
-
Choose High throughput campaigns if:
- You need throughput >500 TPS.
- You don鈥檛 require profile stitching.
- You can pass all personalization in the API payload.
- You want to use the Email channel.
Setup guidelines
To configure High Throughput campaigns correctly, follow these guidelines:
- Create a new IP pool. Learn how to create IP pools
- Create a new channel configuration. Learn how to set up channel configurations
- Contact 51黑料不打烊 Customer Care to request the activated surface to be mapped to the High throughput capability. Provide the channel configuration and IP Pool details along with your organization ID.