# Email Settings

## <span style="color: rgb(245, 89, 64);">**Overview**</span>

This documentation provides a comprehensive guide to configuring email settings in your Voila account, explicitly focusing on integration with MailGun. You will learn how to access the Email Settings section, create a new account, fill in account details, including the MailGun API Key, Domain, and API Base URL, and retrieve these MailGun-specific values from your MailGun account. Following these steps will ensure the successful configuration of your Voila Email Settings, enabling efficient email notification delivery through MailGun.

### <span style="color: rgb(245, 89, 64);">**Accessing the Email Settings Page**</span>

Navigate to the "Notifications" button on the left-hand menu, and select the highlighted "Email Settings" tab in the screen's top right corner.

<video controls="controls" height="473" src="https://shipping-documentation.despatchcloud.app/attachments/222?open=true" style="width: 841px; height: 473px;" width="841"></video>

<p class="callout info">**Click to Play or Pause the Video**</p>

### <span style="color: rgb(245, 89, 64);">**Creating a New Account**</span>

Choose the desired account type from the options available on the left side of the screen, including Mailgun, Amazon SES, or Sendgrid. After selecting your preferred service, click the "Create Account" button to initiate the account creation process. Subsequently, click the highlighted section to access and expand the details of the newly created account, revealing the fields that require completion. Retrieve the essential credentials from your chosen platform, and then conclude the setup by clicking the "Save Account Details" button.

<video controls="controls" height="482" src="https://shipping-documentation.despatchcloud.app/attachments/223?open=true" style="width: 857px; height: 482px;" width="857"></video>

<p class="callout info">**Click to Play or Pause the Video**</p>

### <span style="color: rgb(245, 89, 64);">**Obtaining API Credentials from Mailgun**</span>

To acquire the "MailGun Domain" value, log in to your MailGun account, and from the list of domains, select the one you intend to use. Copy the corresponding domain address and paste it into the designated "MailGun Domain" field within your Voila Email Settings.

For obtaining the "MailGun API Key" and "MailGun API Base URL" values, you have two options: you can either click on the desired domain, as indicated in the highlighted area, to navigate directly to the API key generation page or navigate through the left-hand bar by clicking the "Sending" tab and then proceed to the "Overview" page.

Locate and select the API section on this page, providing you with the required credentials. Subsequently, paste these acquired values into their respective fields: "MailGun API Key" and "MailGun API Base URL" within your Voila Email Settings.

<p class="callout warning">If you are using a Sandbox, make sure that the recipients are authorized in the [Mailgun dashboard](https://app.mailgun.com/app/dashboard).</p>

[![](https://documentation.despatchcloud.com/uploads/images/webp/Shipping/Shipping_ES_06-08.webp)](https://documentation.despatchcloud.com/uploads/images/webp/Shipping/Shipping_ES_06-08.webp)

### <span style="color: rgb(245, 89, 64);">**Obtaining API Credentials from SendGrid**</span>

1. <span data-preserver-spaces="true">Log in to your SendGrid account and access the "Settings" section. You can do this by clicking on "Settings" in the dashboard or using this direct link: </span>[<span data-preserver-spaces="true">SendGrid Settings</span>](https://app.sendgrid.com/settings/api_keys)<span data-preserver-spaces="true">.</span>
2. <span data-preserver-spaces="true">On the "API Keys" page, locate and click the "Create API Key" button, which is positioned in the top right corner.</span>
3. <span data-preserver-spaces="true">Follow the provided instructions to generate an API key. Be aware that the generated API key will be visible only once for security reasons, so copy and paste it into the "API Key" field within your Voila configuration.</span>
4. <span data-preserver-spaces="true">Ensure you have a trusted sender by navigating to the "Settings" section again and selecting "Sender Authentication." Alternatively, use this link: </span>[<span data-preserver-spaces="true">Sender Authentication in SendGrid</span>](https://app.sendgrid.com/settings/sender_auth)<span data-preserver-spaces="true">.</span>
5. <span data-preserver-spaces="true">On the "Sender Authentication" page, you have two options:</span>
    - <span data-preserver-spaces="true">Authenticate a domain, allowing you to send emails from any address under a domain you control.</span>
    - <span data-preserver-spaces="true">Verify a single sender, enabling you to send emails exclusively from a specific address.</span>
6. <span data-preserver-spaces="true">After completing the sender authentication, copy the approved email address and paste it into the "Test Sender" field within your Voila settings.</span>
7. <span data-preserver-spaces="true">Before saving your settings, click the "Test Settings" button to verify your configuration functions correctly.</span>
8. <span data-preserver-spaces="true">In the "Name" field within Voila, you can enter any label that helps you identify this as your SendGrid account. This field is for your reference.</span>

[![](https://documentation.despatchcloud.com/uploads/images/webp/Shipping/Shipping_NES_SendGrip.webp)](https://documentation.despatchcloud.com/uploads/images/webp/Shipping/Shipping_NES_SendGrip.webp)

### <span style="color: rgb(245, 89, 64);">**Obtaining API Credentials from Amazon SES**</span>

<span data-preserver-spaces="true">To set up Amazon SES as your email provider, you must obtain the Test Sender, Region, Key, and Secret details. Follow these steps to complete the setup:</span>

1. <span data-preserver-spaces="true">Log into your AWS account and ensure the selected region aligns with your intended usage. You can do this by expanding the region menu located in the top right corner of the AWS console.</span>
2. <span data-preserver-spaces="true">Next, create an IAM (Identity and Access Management) user with the "AmazonSESFullAccess" policy. You can initiate this process by visiting the </span>[<span data-preserver-spaces="true">IAM User Creation</span>](https://console.aws.amazon.com/iam/home)<span data-preserver-spaces="true"> link.</span>
3. <span data-preserver-spaces="true">Follow the steps outlined in the provided GIF or instructions on the page. After successfully creating the IAM user, click the "Download .csv" option and securely store the downloaded CSV file on your computer. This CSV file contains your Key and Secret credentials.</span>

[![](https://documentation.despatchcloud.com/uploads/images/webp/Shipping/Shipping_NES_AmazonSES_1.webp)](https://documentation.despatchcloud.com/uploads/images/webp/Shipping/Shipping_NES_AmazonSES_1.webp)

<span data-preserver-spaces="true">As the second step in setting up Amazon SES as your email provider, please follow these instructions:</span>

1. <span data-preserver-spaces="true">Go to the Amazon SES Dashboard page to initiate the "Create Identity" process, which authorises a sender email or domain.</span>
2. <span data-preserver-spaces="true">On the SES Dashboard, you have two identity options: verify an entire domain or a specific sender email address. After providing all the necessary information, click the "Create Identity" button at the bottom right corner of the page.</span>
3. <span data-preserver-spaces="true">After completing this step, you must validate the email address or domain. To do this, you must request production access from the SES Dashboard. To do this, click "Account dashboard" on the left-hand menu to navigate this page. You'll find the "Request production access" button at the top of this page. Click it to finalise the process.</span>
4. <span data-preserver-spaces="true">While on your dashboard, you can identify your AWS region in the dropdown menu. Interact with the button at the top right corner; the selected region will be highlighted in orange. For example, it might appear as "eu-west-2." You'll use this region information in your Voila configuration's "Region" section.</span>
5. <span data-preserver-spaces="true">In the last section, you'll find an example of how to input your information into Voila. The "Name" field can be any label you prefer. Use the email address you used during the Amazon SES setup as the "Test Sender." Follow the region instructions mentioned above in the "Region" section. Retrieve the "Key" and "Secret" from the CSV file. Once you've completed all these steps, you can test and save the connection.</span>

[![](https://documentation.despatchcloud.com/uploads/images/webp/Shipping/Shipping_NES_AmazonSES_2.webp)](https://documentation.despatchcloud.com/uploads/images/webp/Shipping/Shipping_NES_AmazonSES_2.webp)