Mailjet API

Flectra is compatible with Mailjet’s API for mass mailing. Set up a dedicated mass mailing server through Mailjet by configuring settings in the Mailjet account and the Flectra database. In some circumstances, settings need to be configured on the custom domain’s DNS settings as well.

Set up in Mailjet

Create API credentials

To get started, sign in to the Mailjet Account Information page. Next, navigate to the Senders & Domains section and click on SMTP and SEND API Settings.

SMTP and Send API Settings link in the Senders & Domains section of Mailjet.

Then, copy the SMTP configuration settings onto a notepad. They can be found under the Configuration (SMTP only) section. The SMTP configuration settings include the server address, the security option needed (Use SSL/TLS), and the port number. The settings are needed to configure Mailjet in Flectra, which is covered in the last section.

Important

Flectra blocks port 25 on Flectra Online and Flectra.sh databases. See reference here.

SMTP configuration from Mailjet.

Next, click on the button labeled Retrieve your API credentials to retrieve the Mailjet API credentials.

Then, click on the eye icon to reveal the API key. Copy this key to a notepad, as this serves as the Username in the Flectra configuration. Next, click on the Generate Secret Key button to generate the Secret Key. Copy this key to a notepad, as this serves as the Password in the Flectra configuration.

Add verified sender address(es)

The next step is to add a sender address or a domain to the Mailjet account settings so that the email address or domain is approved to send emails using Mailjet’s servers. First, navigate to the Mailjet Account Information page. Next, click on the Add a Sender Domain or Address link under the Senders & Domains section.

Add a sender domain or address in the Mailjet interface.

Determine if a sender’s email address or the entire domain needs to be added to the Mailjet settings. It may be easier to configure the domain as a whole if DNS access is available. Jump to the Add a domain section for steps on adding the domain.

Note

Either all email addresses of the Flectra database users who are sending emails using Mailjet’s servers need to be configured or the domain(s) of the users’ email addresses can be configured.

By default, the email address originally set up in the Mailjet account is added as a trusted sender. To add another email address, click on the button labeled Add a sender address. Then, add the email address that is configured to send from the custom domain.

At minimum the following email addresses should be set up in the provider and verified in Mailjet:

  • notifications@yourdomain.com

  • bounce@yourdomain.com

  • catchall@yourdomain.com

Note

Replace yourdomain with the custom domain for the Flectra database. If there isn’t one, then use the mail.catchall.domain system parameter.

After that, fill out the Email Information form, making sure to select the appropriate email type: transactional email or mass emails. After completing the form, an activation email is sent to the email address and the trusted sender can be activated.

It is recommended to set up the SPF/DKIM/DMARC settings on the domain of the sender.

Important

If the database is not using a custom domain, then in order to verify the sender’s address, a temporary alias (of the three email addresses mentioned above) should be set up in Flectra CRM to create a lead. Then, the database is able to receive the verification email and verify the accounts.

Add a domain

By adding an entire domain to the Mailjet account, all the sender addresses related to that domain are automatically validated for sending emails using Mailjet servers. First, navigate to the Mailjet Account Information page. Next, click on Add a Sender Domain or Address link under the Senders & Domains section. Then, click on Add domain to add the custom domain.

Note

The domain needs to be added to the Mailjet account and then validated through the DNS.

After that, fill out the Add a new Domain page on Mailjet and click Continue.

After adding the domain, a validation page will populate. Unless the Flectra database is on-premise (in which case, choose Option 1), choose Option 2: Create a DNS Record. Copy the TXT record information to a notepad and then navigate to the domain’s DNS provider to complete validation.

The TXT record information to input on the domain's DNS.

Setup in the domain’s DNS

After getting the TXT record information from the Mailjet account, add a TXT record to the domain’s DNS. This process varies depending on the DNS provider. Consult the provider for specific configuration processes. The TXT record information consists of the Host and Value. Paste these into the corresponding fields in the TXT record.

Return to Mailjet account information

After adding the TXT record to the domain’s DNS, navigate back to the Mailjet account. Then, navigate to Account Information ‣ Add a Sender Domain or Address, click the gear icon next to Domain, and select Validate.

This action can also be done by going to the Sender domains & addresses page on the Mailjet account information and clicking on Manage.

Next, click Check Now to validate the TXT record that was added on the domain. A success screen will appear if the domain is configured correctly.

Check DNS record in Mailjet.

After successfully setting up the domain, there is an option to Authenticate this domain (SPF/DKIM). This button populates SPF & DKIM provider.

Authenticate the domain with SPF/DKIM records in Mailjet.

Set up in Flectra

To complete the setup, navigate to the Flectra database and go to the Settings. With Developer Mode (debug mode) turned on, go to the Technical Menu ‣ Email ‣ Outgoing Mail Servers. Then, create a new outgoing server configuration by clicking on the Create button.

Next, input the SMTP server (in-v3.mailjet.com), port number (587 or 465), and Security (SSL/TLS) that was copied earlier from the Mailjet account. They can also be found here. It is recommended to use SSL/TLS even though Mailjet may not require it.

For the Username, input the API KEY. For the Password, input the SECRET KEY that was copied from the Mailjet account to the notepad earlier. These settings can be found on Mailjet ‣ Account Settings ‣ SMTP and SEND API Settings.

Then, if the Mailjet server is used for mass emailing, set the Priority value higher than that of any transactional email server(s). Finally, save the settings and Test the Connection.

Flectra outgoing email server settings.

Important

In order for the notifications feature to work using Mailjet, there are three settings that need to be set in Flectra.

  1. The From Filter needs to be set on the server configuration. It is recommended to set it as a domain and not a full email address. It should match the domain in the two proceeding steps. More information can be referenced here.

  2. The mail.default.from system parameter must have the value notifications@yourdomain.com.

  3. The mail.default.from_filter system parameter must have the value yourdomain.com. Replace yourdomain with the custom domain for the Flectra database. If there isn’t one, then use the mail.catchall.domain system parameter.

For more information see Using a default email address.

The System Parameters can be accessed by activating Developer Mode (debug mode) in the Settings ‣ Technical ‣ Parameters ‣ System Parameters menu.

Once the setup is complete, the Flectra database is ready to use the Mailjet email server for mass mailing or transactional emails!