Using Mailjet with Nicoka

Mailjet sends your bulk emails to the contacts and candidates you select in Nicoka, from your Mailjet senders. Nicoka creates the list in Mailjet, starts the campaign and logs the send on each record; in return, Mailjet reports unsubscribes and failing addresses to Nicoka.

Before you start

• You have a Mailjet account that can send email campaigns, with at least one validated sender.
• You are an administrator of your Nicoka workspace.

Step 1: Get your Mailjet API key and secret key

Sign in to your Mailjet account and create your Mailjet API key and secret key from your account settings. If you cannot find this option, see Mailjet's help. This information is confidential: do not send it by email or in a ticket, and enter it into Nicoka yourself.

Step 2: Create the service in Nicoka

1. In the side menu, open Customizing > Administration, then, under Cross Application, click Services.
2. Click Create a new service.
3. Enter a Label (for example "Mailjet"), choose the Type Mailjet and, if needed, restrict who can use the service with Available for.
4. Click Create. The service is created disabled.

Step 3: Enter your Mailjet credentials

1. On the line of the service, click the padlock in the Pwd column.
2. Paste your API key into API Key and your secret key into API Secret.
3. Leave Webhook Secret empty: Nicoka generates it.
4. Click Update.

When you save, Nicoka automatically registers its webhook with Mailjet: this is how Mailjet reports unsubscribes to Nicoka. If the message "Authentication saved, but webhook upsert failed" appears, check the credentials you copied.

Step 4: Set up the service

Click the gear icon in the Customize column, then click Update once you have made your choices.

• Add unsubscribe footer (ticked by default): adds an unsubscribe link to emails that do not contain one.
• Synchronization treatment: for contacts, candidates and employees, choose a list variant and the Mailjet list to keep up to date. This treatment runs in the background; its frequency is set by the Nicoka team, contact support to set it up.
• Attribute mapping: for each Nicoka fields entry, the Mailjet attribute that receives it (Service attributes). First name, last name, email and title are always sent; an attribute missing in Mailjet is created there.
• Sender access: reserve a Mailjet sender for some users, groups or profiles. A sender without a rule stays available to everyone.

Step 5: Activate the service

Click in the Active column of the line: the check mark appears. Nicoka does not check the keys on activation: no error message at step 3 is the right signal.

Send a bulk email

1. In a contact or candidate list, select the people, then choose the Send a message action.
2. Choose Email marketing service instead of Email inbox.
3. In From, choose the Mailjet sender. In Target, choose Selection (the ticked records) or Entire variant (all the records of the displayed list).
4. Write the subject and the message, then send.

Nicoka creates a list in Mailjet, imports the recipients into it and starts the campaign. The message "Email sent via the email marketing service. Campaign #…" gives the number of the campaign in Mailjet.

• People without a valid email and people who opted out of email marketing are excluded from the send.
• The subject and the message must not contain Nicoka tags, and the preview is not available in this mode.
• A send is capped in number of recipients: above it, Nicoka shows the limit and the number of people targeted.
• Attachments are not accepted.

Add people to a Mailjet list

1. In a contact or candidate list, select the people, then choose the Add to an email marketing list action.
2. In List Mailjet, choose an existing list or New list.
3. Click Add to send the selected records, or Synchronize to send all the records of the displayed variant.

People who opted out of email marketing are not added. A person unsubscribed in Mailjet is not subscribed again by Nicoka.

What you get in Nicoka

• An activity on each recipient's record, with the number of the Mailjet campaign.
• When Mailjet reports an unsubscribe, a bounce, a spam report or a blocked address, the Has opted out of email box is ticked on every record (contacts, candidates, employees) with that address. These people are then excluded from sends.
• Open and click statistics stay in Mailjet: find them with the campaign number.

See also

Nicoka also offers bulk sending with Brevo, and lists the good practices for bulk email.

Need help?

If you would like help with the setup, contact Nicoka support.