About Sender Details

With the Sender Details API you can manage senders for your email campaigns. Sender details consist of a name and an email address, where the email address must be verified through the Sender Emails API beforehand.

You can have multiple senders per site. Using multiple senders allows your letters to come from addresses associated with specific parts of your business. For example, you could have one automated email from bookings@website.com and another from sales@website.com.

With the Sender Details API you can:

• Create, Delete, and Update a sender.
• Mark a sender as default and get the default sender details.
• List sender details.

Before you begin

It's important to note the following:

• The first sender you create is automatically marked as the default.
• Currently, there's a limitation when publishing an email campaign with the Campaign API. The API automatically publishes campaigns from the default sender only. Therefore, whenever you want to publish a different campaign, appropriate sender must be set as the default.
• If you didn't create any senders, your email campaigns are sent from a domain provided by Wix.
• You can't delete a default sender. To delete it, you must first create a new sender, mark it as the default, and only then delete the original sender.
• To add additional senders, you must have Core or Advanced Email Marketing plans.
• You can't have multiple senders with the same name and email address. If you want to use the same email for multiple senders, the names must be different.

Use cases and flows

• Publish an email campaign from a new sender

Terminology

• Sender: A combination of a verified email address and a name used to represent the source of an email campaign.
• Campaign: A single, organized effort to send marketing emails to a list of recipients.
• Verified Email: An email address that has passed the verification process with the Sender Emails API, allowing it to be used in campaigns.