- How to Enable Mailjet in Azure
- How to Configure Your Mailjet Login Details
- How to Reference the Mailjet .NET Class Library
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.
- 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
Log into your Azure account, then click on ‘New’.
Once there, enter ‘Mailjet’ in the search bar and select the ‘Mailjet Email Service’ result:
Click on ‘Create’ to start the sign-up.
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.
Select your ‘Subscription’.
- 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.
- Select your ‘Location’.
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.
Click on ‘Review Legal Terms’. Read and review the Terms and click on ‘Purchase’ to accept them.
Tick the ‘Pin to dashboard’ checkbox to be able to find the Mailjet resource more easily after the deployment.
Click on ‘Create’ to start the deployment.
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
Access the Mailjet configuration screen from Azure, then click on ‘Manage’.
You will arrive at your ‘Mailjet Account Settings’ page.
Under ‘REST API’, click on ‘Master API key & Sub API key management’.
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.
Click on ‘Manage’ to access your Mailjet Account Settings.
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.
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.
It is highly recommended to also configure your SPF and DKIM records to highly improve the deliverability of your emails.
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
<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:
In Visual Studio, click on ‘New Project’, then choose a Template.
In Visual Studio, go to ‘Tools’ → ‘NuGet Package Manager’ → ‘Package Manager Console’ to open the Console.
Select the Project from the ‘Default Project’ menu, then enter ‘Install-Package Mailjet.Api’ in the Console to install it.
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: -
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;
For all of the recommended configurations, please check out the Mailjet Developer Zone at dev.mailjet.com.
Of course, feel free to contact our Customer Support team, in case you come across any technical difficulties with the Mailjet product - our team of specialists will be more than happy to assist you! Please visit the Mailjet ‘Contact Us’ page for more information.
How long does a Mailjet resource plan last?
Each Mailjet resource plan is valid for and automatically renews every 30 calendar days, unless downgraded (deleted) or upgraded.
How do I Upgrade?
You can upgrade to the higher resource plan at any time (i.e. from Bronze to Gold). Go to your Mailjet resource, click on the ‘Pricing Tier’ and select the higher priced plan that fits your needs. The higher priced plan will renew automatically after 30 days.
How do I Downgrade?
You can downgrade to a lower priced or free plan at any time (i.e. from Gold to Bronze). Go to your Mailjet resource, click on the ‘Pricing Tier’ and select the lower priced plan that fits your needs. The downgrade to the lower priced plan takes place immediately. Any unused credits from the previous plan will not be transferred. The new lower priced (or free) plan will renew automatically each 30 days.
Do the Azure Mailjet resource plans have hard or soft email sending limits?
Due to the infrastructure of Azure, the Mailjet plans on Azure have hard limits. This means that if you subscribe to a Bronze plan with 40,000 emails credits you have 30 days to use those email credits and should you need more within that same 30 day period, you will need to purchase a higher rate plan. Purchasing a higher rate plan goes into effect immediately.
What happens to my Mailjet data (contacts, mail lists, campaigns, etc.) when I delete my Mailjet resource on Azure?
All data on Mailjet is kept intact when you delete your Mailjet resource from Azure. However your API key will be disabled, so you will not be able to use any Mailjet services. Since the link between Mailjet and Azure is based on your subscription ID, should you decide to create a new Mailjet resource with the same Azure subscription ID, you will regain access to your user information and your API key will be activated. The API Public and API Secret Keys will not be modified during deletion/creation of a Mailjet resource with the same subscription ID and you will not need to go through the activation process again.
What if I want to completely delete my Mailjet data?
Account suspension and deletion is done manually. To request deletion, please open a support ticket to Mailjet, providing your Azure subscription ID and reason for deletion.
I can’t access the Mailjet management screen or the Mailjet API doesn’t work
Your account might have been temporarily or permanently blocked by Mailjet due to violation of the Terms of Service or Sending Policy. To clarify and resolve the issue you should open a support ticket, providing your Azure subscription ID.
We hope you find this guide helpful. Feel free to let us know what you think of the Mailjet Email Service integration process, and especially what functionality we should do next by emailing email@example.com.
Mailjet Integrations Team