Channels for SMTP and API

Note: Maximum allowed length of a channel name is 191 characters

When sending emails with SMTP or API, Elastic Email organizes your email flow by channels instead of dividing them into separate campaigns with each new job. Specifying (or creating) channels is a little different for both of these sending methods.
​

If you want to specify a channel to send through when using SMTP connection, you will have to set up a custom header when composing your email job that should look like:

Channel: YourChannelNameHere

OR

X-ElasticEmail-Channel: YourChannelNameHere

This will either send your emails through channel "YourChannelNameHere" or first create it and then send through it if the channel with this name doesn't exist already.

Please remember that for custom headers to work, you will have to have the "Custom headers" option turned on. You can check this option on the Settings>Advanced.

For detailed information on how to specify a channel name in API calls, please refer to the official Elastic Email REST API Documentation. You will typically find the ChannelName parameter within the Options object of relevant API endpoints, such as POST /emails.

As with SMTP, when a successful API call with a channel name included is made, the email will be placed in the relevant channel, or the channel will be created first if necessary.

After sending a successful email with SMTP or API with a channel parameter or header, you can search for the channels you have created in the Activity>Channels tab.

If you have any additional questions, please contact our 24/7 Customer Support for assistance.