What is a configuration set?
A configuration set is a collection of rules that you apply to your emails. Associating an ip pool with a sender address in a configuration set simplifies the sending process and avoids passing multiple parameters. You can use configuration sets to customize sending rules for different email types, such as marketing and transactional messages, improving sending efficiency and optimizing your overall marketing results.
Future updates will add support for additional options, such as unsubscribe management, data tracking settings, and email tags.
Manage configuration sets
1. Configure in the console
Path: Email Settings > Configuration Sets
To create a configuration set, click the Create Configuration button in the upper-right corner of the page. Enter a configuration name and description, select an associated ip pool, and specify whether to enable public channel fallback.
On this page, you can also edit or delete existing configuration sets.
Public channel fallback: If this option is enabled and no IPs are available in the associated ip pool, the system automatically uses a public IP to send the email.
If you select No: By default, the system does not fall back to the public channel. As an exception, a dedicated IP during automatic warm-up still falls back. After the warm-up is complete, the IP no longer falls back.
2. Apply configuration sets
When you send emails through the console, API, or SMTP, the system automatically applies the configuration set associated with the sender address. You do not need to specify the configuration set in your code. For more information, see Three Ways to Send Email.
Use configuration sets
You can associate a configuration set with a sender address.
Click Associate Configuration Set or Change Configuration Set. In the dialog box that appears, you can select from your existing configuration sets. Each sender address can be associated with only one configuration set, but multiple sender addresses can be associated with the same configuration set.
After making a selection, click Confirm Association to complete the process.
FAQ
Q: If I specify ip pool A when creating an email sending task, but the sender address is associated with a configuration set that uses ip pool B, which ip pool will be used for sending?
A: ip pool A will be used.
The following precedence logic applies to settings specified in an email sending task versus those in an associated configuration set:
If you do not specify settings such as an ip pool or email tags in your API request or console task, and the sender address is associated with a configuration set, the system uses the settings from that configuration set.
If you have specified settings such as an ip pool or email tags in your API request or console task, these settings take precedence over those in the associated configuration set. This allows you to temporarily switch an ip pool or perform A/B testing.