• Introduction
• How to Enable Mailjet in Azure
• How to Configure Your Mailjet Login Details
• How to Reference the Mailjet .NET Class Library
• Troubleshooting
• FAQ
• Conclusion

Introduction

Azure allows developers to host, deploy and manage Web applications without the complexity of building and maintaining the infrastructure typically associated with developing and launching an application. By integrating with Azure, Mailjet helps developers save time and money by providing a transactional and marketing email service all from within the Azure platform.

Azure end users can benefit from Mailjet’s REST-ful API, SMTP relay and optimized deliverability to:

• send and receive timely messages and alerts;
• parse inbound traffic;
• track email events in real time;
• synchronize their data back into their applications hosted on Azure.

In addition, Mailjet also offers an integrated MJML framework to create responsive HTML email templates.

Developers also gain access to an advanced user interface which includes a real-time metrics dashboard and advanced email marketing features such as A/B testing, Real-time Monitoring, Campaign Comparison and Segmentation. Mailjet provides global customer support in six different languages.

Developers and the technical community are very important to Mailjet. This is why we are very excited to provide Mailjet as an App Service from directly within the Azure Marketplace.

Now, let’s get started!

How to Enable Mailjet in Azure

Azure users can take advantage of the variety of Mailjet subscription options, from 25 000 emails monthly for the Mailjet Free plan, to 9 000 000 monthly for the Platinum plan. All subscription options (including the Free plan) will give you access to the Mailjet API, SMTP Relay and Responsive Marketing Tool; Tracking, Advanced Reporting and Personalization options; Unlimited Contacts and Global Deliverability.

How To Install Mailjet Email Service in Azure

1. Log into your Azure account, then click on ‘New’.

   

2. Once there, enter ‘Mailjet’ in the search bar and select the ‘Mailjet Email Service’ result:

   

   

3. Click on ‘Create’ to start the sign-up.

   

4. You will now need to submit a ‘Name’ to identify the Mailjet Email Service in your Azure settings. The name needs to be between 2 and 64 characters long and alphanumeric. It must start with a letter.

   

5. Select your ‘Subscription’.

6. Choose an existing ‘Resource Group’ for the Mailjet Email Service, or create a new one. Keep in mind that the Resource Group name should be up to 90 characters long, can only include alphanumeric characters, periods, underscores, hyphens and parenthesis. It cannot end in a period.
7. Select your ‘Location’.

8. Choose a ‘Pricing Tier’. When you click on each plan, you will see the features it contains. There will also be an option for you to enter a promotional code, in case you have one. After reviewing the features and entering the code, click on ‘OK’ and then on ‘Select’ to submit your choice.

   

9. Click on ‘Review Legal Terms’. Read and review the Terms and click on ‘Purchase’ to accept them.

   

10. Tick the ‘Pin to dashboard’ checkbox to be able to find the Mailjet resource more easily after the deployment.

11. Click on ‘Create’ to start the deployment.

    

12. Once the deployment has finished, you will see a ‘Deployment Succeeded’ pop-up notification. You will be able to find the Mailjet resource on the Dashboard, if the ‘Pin to Dashboard’ option has been selected during the setup. Otherwise, you will find it in the ‘All Resources’ section of the main menu.

    

Any status updates or errors encountered during the deployment will be listed in the ‘Notifications’ area on the Azure home screen.

How to Activate your Mailjet Account

All new accounts get activated immediately so you can access your resource and start creating awesome еmail campaigns right away.

However, to warm-up and protect the sending reputation of your brand new Azure Mailjet account, your sending bandwidth is limited at the beginning but will progressively increase over time.

Should you need a high amount of sending bandwidth from the start, please note that this requires a custom warm-up and monitoring plan and could require the assistance of our Support Team. To get in touch and know what your options are, please contact us anytime with the following information:

• Full name
• Email – very important so we can get in touch with you with regards to the status of your warm-up process
• Website URL
• What type of emails you plan on sending (transactional, notification, bulk marketing emails, etc.)
• Estimated email volume you plan on sending per month
• Sending frequency and any other sending patterns your email activity may have (i.e. my application will regularly send emails over time OR my application generally sends lots of emails on Monday, Wednesday and Friday with the peak sending being 200k emails in one hour)

The above allows our Support Team to optimize the configuration of your account and in the case of migrating over a high volume of email from a different provider to Mailjet, also creating a custom warm-up and monitoring plan to ensure that your switch to Mailjet is a smooth process and avoids any turbulence.

How to Find Your Mailjet API Keys

1. Access the Mailjet configuration screen from Azure, then click on ‘Manage’.

   

2. You will arrive at your ‘Mailjet Account Settings’ page.

   

3. Under ‘REST API’, click on ‘Master API key & Sub API key management’.

   

4. You will see your ‘Public’ and ‘Secret API Key’ here. You will also see any Sub-account API Keys that may have been added.

   

How to Configure Mailjet for Use

Once Mailjet is deployed successfully, you will need to complete several steps on the Mailjet side to be able to send your first email.

1. Click on ‘Manage’ to access your Mailjet Account Settings.

   

2. Validate a Sender Address for your newly provisioned Mailjet resource. To do this, click on ‘Add a Sender Domain or Address’ from your Account page.

   

    

   

3. Then add a new sender address. If you want to use many email addresses linked to the same top level domain, you can add the domain instead. For more information, please see the Mailjet FAQ.

   

4. It is highly recommended to also configure your SPF and DKIM records to highly improve the deliverability of your emails.

5. You can also decide whether or not to use Mailjet’s open and click tracking (by default the ‘open’ and ‘click’ tracking is activated). To change your tracking, simply click on ‘Settings’ in the ‘Account’ Section → ‘Account Preferences’.

   

   

   You can also customize the tracking links to improve your deliverability and make it more attractive to your customers.

How to Configure Your Mailjet Login Details

Once you create your Mailjet resource, you will be able to use the Mailjet services immediately via Azure.

If going through Azure every time in order to use Mailjet is inconvenient for you, you may want to design your templates, send campaigns, manage contacts etc. by accessing Mailjet directly. However, you will first need to create your Mailjet login details (email and password).

Configure Your Mailjet Email

Your Mailjet login email will be automatically generated as azure+<sub-id>@mailjet-azure.com, where <sub-id> is the subscription ID for your Mailjet resource.

You will need to change the login email to a real email address of yours - go into your Mailjet resource and click on ‘All settings’ → ‘Communications’

Enter your first name, last name and new email address, then ‘Save’ the information.

Configure Your Mailjet Password

Once your Mailjet resource is created, a ‘Set Password Link’ is automatically generated for it. You can find it under ‘All settings’ → ‘Properties’.

Copy the link to your clipboard and use it to open the password generation web page. Then select your new Mailjet password.

Once you have configured your Mailjet email and password, you will be able log into Mailjet from our sign-in page.

How to Reference the Mailjet .NET Class Library

The Mailjet NuGet Package is an easy way to retrieve the Mailjet API and configure your application with all dependencies. NuGet is a Visual Studio extension that facilitates installing and updating tools and libraries. It is included with Microsoft Visual Studio 2015 and above. 

To install the Mailjet NuGet package, follow these instructions:

1. In Visual Studio, click on ‘New Project’, then choose a Template.

   

2. In Visual Studio, go to ‘Tools’ → ‘NuGet Package Manager’ → ‘Package Manager Console’ to open the Console.

   

3. Select the Project from the ‘Default Project’ menu, then enter ‘Install-Package Mailjet.Api’ in the Console to install it.

   

4. Once installed, you will be able to view the installed dependency under ‘Dependencies’ → ‘NuGet’ → ‘Mailjet.Api’.

Mailjet.Api is the name of Mailjet’s .NET class library. It contains the following namespaces: - Mailjet.Client - Mailjet.Client.Resources

Add the following code namespace declarations at the start of a C# file, in which you want to programmatically access the Mailjet Email Service.

using Mailjet.Client;
using Mailjet.Client.Resources;