How to Send Emails with Twilio SendGrid on EU Servers

How to Send Emails with Twilio SendGrid on EU Servers

With a growing emphasis on data protection and regional compliance, businesses are increasingly seeking ways to ensure their data remains within specific geographical boundaries. Twilio SendGrid has introduced the capability to send outbound emails using servers located in the European Union, providing an enhanced level of data sovereignty.

In this post, you'll learn how to configure your SendGrid setup to keep your data within the EU. This includes steps to create regional subusers, assign dedicated IPs, configure DNS records, and utilize the SendGrid API at the api.eu.sendgrid.com endpoint.

Let’s see how to set this up!

There are two possible configurations for this use case: you can either create one or more subusers specifically for sending emails via the EU region, or just use the parent account for this purpose. The overall process is similar for both approaches, with the key difference being the API key used to assign the IP addresses. In this guide, we'll focus on the first scenario, where emails are sent by a specific EU subuser.

Prerequisites

Before starting, you will need a Twilio SendGrid Pro or Premier Account. If you don’t yet have one, you can sign up for an account here.

Step-by-Step Instructions

Once you have the sendgrid account in place, you’re ready to set up a subuser to send from the EU! These next steps will walk through what you’ll need.

• A SendGrid API Key with Full Access permission on the Parent Account
• Procure EU IP Address for the EU Subuser
• A Sendgrid subuser that will be bound to the EU region
• A SendGrid API Key with atleast mail-send permission on the Newly created Subuser Account
• Sender Authentication to verify that you own the email address or domain that you send emails from.
• Send an email via this newly created subuser.

Create an API Key for the parent account

Login to your parent account and create a your API key using the Sendgrid app console

Click Create & View, and then save the value of the key somewhere safe – it is only shown once in your console.

IP procurement and assignment

Add a regional IP and assign to parent account and subusers:

The next step is to add a regional IP address and assign it to the parent account and/or the newly created subuser.

The cURL command below demonstrates how to add an EU-based IP address and assign it to both the subuser and the parent accounts. For the complete details on this endpoint, refer to the Add a Twilio SendGrid IP Address documentation.

cURL Example:

And the response should look something like this:

To obtain the correct subuser_id for the code above, you would first need to list all the subusers. You can do this by following the instructions provided in the Twilio SendGrid API documentation for listing all subusers. An example is below.

Here is an example response for the above command:

If you want to add an EU-based IP address to an existing subuser, here’s how you can do it:

And here is an example response:

Create a regional subuser

To create a subuser in the EU region, start by reviewing the SendGrid Subusers API documentation or by following the cURL example provided below. Be sure to specify the region as eu when configuring the subuser.

cURL Example:

And the response is below:

Complete Sender Authentication

Now that we have created a subuser and assigned it an EU IP address, the next step is to complete the domain authentication for this subuser.

You can complete domain authentication either via the SendGrid UIor through the API. Follow the steps below to complete domain authentication via the API. Each step includes links to the relevant documentation and an example cURL command.

Step 1: Authenticate your domain for the EU region

To authenticate your domain for the EU region, follow the instructions in the Authenticate a Domain documentation.

Run the initial command to authenticate your domain, which will give you the DNS records you need to add to your DNS host. This step also provides you with the domain_id.

And the response should be something like this:

Step 2: Retrieve the domain_id

Use the provided cURL command to list all authenticated domains and obtain the domain_id for your specific domain.

After running the cURL command to authenticate your domain, you'll need to add the DNS records provided by SendGrid to your DNS host.

Step 3: Validate the domain authentication

After setting up your DNS records, the next step is to validate your domain authentication. This ensures that your DNS records are correctly configured and your domain is ready for use.

Refer to the Validate Domain Authentication documentation for more details.

And the response should look something like this:

Step 4: Associate the authenticated domain with your EU-Based Subuser

After validating your domain, the next step is to associate the authenticated domain with your EU-based subuser. This ensures that the subuser can send emails using the authenticated domain.

Refer to the documentation on associating an authenticated domain with a subuser for detailed instructions.

Step 5: Create a branded link

To create a branded link, you can use the following cURL command. This branded link will be associated with the specified domain in the EU region.

Here’s the cURL command to create a branded link:

Step 6: Validate the branded link

After creating a branded link, the next step is to validate it to ensure it’s correctly set up. Use the following cURL command to validate your branded link:

Use the specific LINK_ID you received when you created the branded link.

Step 7: Associate the branded link with your Subuser

Once the branded link is validated, you can associate it with a specific subuser. This allows the subuser to send emails using the branded link.

Your domain has been successfully verified, and you’re now all set to use it for sending emails!

Create a SendGrid API Key to send emails for the Subuser

SendGrid offers three types of API keys: Full Access, Restricted Access, and Billing Access, each with specific permissions. The first key must be created via the Twilio SendGrid App. Subsequent keys can be managed using the API. More info can be found here.

Create an API Key in the Console

In the SendGrid Console, navigate to the API Keys section under Settings on the Console landing page. Click Create API Key in the top right corner to open a form on the right side. Name your API key and choose Restricted Access to set permissions.

For security, assign only the necessary permissions. In this tutorial, you'll only need the Mail Send permission. To enable it, scroll to the Mail Send section under Access Details and move the slider to the right.

Finally, click Create & View at the bottom of the form. The API key will be displayed on the screen. Since you won’t be able to retrieve it again after leaving this page, make sure to copy and store the secret securely

Send your email

With your API Key for the EU subuser ready, you can now send an email using the EU-specific base URL api.eu.sendgrid.com.

The cURL command below demonstrates how to send an email through SendGrid's EU region. Simply replace the placeholder email addresses with your authenticated sender email in the "from" field and your recipient's email in the "to" field. For additional details on sending emails programmatically, refer to the full Mail Send API documentation.

Conclusion

Twilio SendGrid enables you to manage email sending and receiving at scale.

In this guide, you learned how to send emails in the EU region using Twilio SendGrid's Email API. Here are the steps you performed:

• Created a subuser assigned to the EU region.
• Provisioned an IP address in the EU.
• Authenticated your domain for sending emails.
• Created a SendGrid API Key with email sending permissions.
• Send an email using the api.eu.sendgrid.com endpoint.

Interested to know more about Sendgrid? Check out our Email API documentation. We can’t wait to see what you build!

Yukti Ahuja is a Principal Solutions Engineer at Twilio. As an SE, she is a problem solver extraordinaire, blending technical expertise to bridge the gap between complex technology and practical solutions for customers.