What is a configuration set?
A configuration set is a collection of rules for the emails you send. Currently, it allows you to associate an ip pool with a sender address. This simplifies sending, as you only need to reference the configuration set instead of multiple parameters. You can use configuration sets to customize sending rules for different email types, such as marketing email and transactional email. This improves sending efficiency and overall performance.
Support for features like unsubscribe levels, data tracking, and email tags is planned for a future release.
Configuration sets are optional.
Manage configuration sets
1. Configure in the console
Navigation: Email settings > Configuration sets
To create a configuration set, click the "Create Configuration" button in the upper-right corner. Enter a name, description, the associated ip pool, and specify whether to enable fallback to shared IPs. After you enter this information, the configuration set is created.
You can also edit or delete existing configuration sets on this page.
Fallback to shared IPs: If this option is enabled, the system automatically uses shared IPs for sending when no dedicated IPs are available in the associated ip pool.
If you select "No": The system does not fall back to shared IPs by default. The exception is for dedicated IPs undergoing an automatic warm-up, which will still fall back to shared IPs. After the warm-up is complete, fallback is disabled.
2. Use a configuration set
When you send emails via the console, API, or SMTP (see: Three ways to send email), the system automatically applies the configuration set associated with the sender address. You do not need to specify it in your code.
Associate a configuration set
You can associate a configuration set with a sender address. When you send an email, the platform automatically applies the configuration set associated with that sender address.
Click "Associate Configuration Set" or "Change Configuration Set". A dialog box appears where you can select from your existing configuration sets. While a sender address can be associated with only one configuration set, a single set can be used by multiple sender addresses.
After selecting a set, click "Confirm Association".
FAQ
Q: If I specify ip pool A when creating a sending task, but the sender address is associated with a configuration set that uses ip pool B, which ip pool is used?
A: The system uses ip pool A.
Order of precedence for sending task settings versus configuration set settings:
If you do not specify settings (such as the ip pool or email tags) in your API request or sending task, the system uses the settings from the configuration set associated with the sender address.
If you specify settings such as the ip pool or email tags in your API request or sending task, they override the configuration set's settings. This allows you to temporarily switch ip pools or perform an A/B test.