Mailjet Mail

Mailjet is an email delivery and marketing platform that exposes REST APIs for sending transactional and marketing emails, managing contacts and contact lists, and tracking campaign and message performance. This connector lets you ingest Mailjet resources such as contacts, campaigns, messages, and statistics into Nexla, and send data back to Mailjet to create contacts, manage lists, and trigger email sends.

Power end-to-end data operations for your Mailjet Mail API with Nexla. Our bi-directional Mailjet Mail connector is purpose-built for Mailjet Mail, making it simple to ingest data, sync it across systems, and deliver it anywhere — all with no coding required. Nexla turns API-sourced data into ready-to-use, reusable data products and makes it easy to send data to Mailjet Mail or any other destination. With comprehensive monitoring, lineage tracking, and access controls, Nexla keeps your Mailjet Mail workflows fast, secure, and fully governed.

Features

Type: API

SourceDestination

• Seamless API Integration: Connect to any endpoint as source or destination without coding, with automatic data product creation
• Visual Composition & Chaining: Build complex integrations using visual templates, chain API calls, and compose workflows with data validation and filtering
• API Proxy: Expose curated slices of your data securely with a secure and customizable API proxy that validates and transforms data on the fly
• Request optimization with intelligent batching, retry, and caching to minimize API calls and costs

Prerequisites

Before creating a Mailjet Mail credential, you need your Mailjet API Key and API Secret Key. Every Mailjet REST API request is authenticated with HTTP Basic Auth, where the API Key is used as the username and the API Secret Key is used as the password.

To obtain your Mailjet API keys, follow these steps:

1. Sign in to your Mailjet account at app.mailjet.com.

2. Open Account settings, then navigate to the API Key Management (Primary and Sub-accounts) page.

3. Locate the API Key you want to use. The API Key is displayed directly on this page.

4. Copy the corresponding Secret Key. For security, the Secret Key is shown in full only when the key pair is first generated, so store it in a secure location. If you no longer have it, click the gear icon next to the API Key and select Reset Secret Key to generate a new Secret Key.

5. Note the base URL for the Mailjet API, which is https://api.mailjet.com for the standard Email API.

Both keys are generated automatically when your Mailjet account is created and act like a username and password pair for authenticating REST API requests. Treat the Secret Key as sensitive information — if it is ever compromised, reset it from the API Key Management page. For more detail, see the Mailjet Email API Authentication guide and API Key Configuration reference.

Authenticate

Credentials required

HTTP Basic Authentication using Mailjet API Key ID as username and API Key Secret as password.

Field	Required	Secret	Description
API Key	Yes	No	Your Mailjet API Key (used as the HTTP Basic Auth username).
API Secret Key	Yes	Yes	Your Mailjet API Secret Key (used as the HTTP Basic Auth password).
Base URL	Yes	No	The base URL for the Mailjet API.

Create a credential in Nexla

1. After selecting the data source/destination type, click the Add Credential tile to open the Add New Credential overlay.

2. Enter a name for the credential in the Credential Name field and a short, meaningful description in the Credential Description field.

3. Enter your Mailjet API Key in the API Key field. This value is used as the HTTP Basic Auth username.

4. Enter your Mailjet API Secret Key in the API Secret Key field. This value is used as the HTTP Basic Auth password and must be kept confidential.

5. Enter the Base URL for the Mailjet API. Unless you have been directed to a different endpoint, use https://api.mailjet.com.

   If your API Secret Key is ever compromised, reset it from the Mailjet API Key Management page and update this credential with the new value.

   For more information about Mailjet authentication and API keys, see the Mailjet Email API Authentication guide.

6. Click the Save button at the bottom of the overlay. The newly added credential will now appear in a tile on the Authenticate screen during data source/destination creation.

Use as a data source

To create a new data flow, navigate to the Integrate section, and click the New Data Flow button. Select the Mailjet Mail connector tile, then select the credential that will be used to connect to Mailjet, and click Next; or, create a new Mailjet Mail credential for use in this flow.

Endpoint templates

Nexla provides pre-built templates that can be used to rapidly configure data sources to ingest data from common Mailjet endpoints. Select the endpoint from which this source will fetch data from the Endpoint pulldown menu. Available endpoint templates are listed in the expandable boxes below.

[Rest API] List Contact Lists

Returns a list of all contact lists in the Mailjet account.

This endpoint retrieves records from the Mailjet /v3/REST/contactslist endpoint. Nexla automatically paginates through the results using offset-based paging.

For details on response fields, see the Mailjet contact lists API documentation.

[Rest API] List Contacts

Returns a list of all contacts in the Mailjet account.

This endpoint retrieves records from the Mailjet /v3/REST/contact endpoint. Nexla automatically paginates through the results using offset-based paging.

For details on response fields, see the Mailjet contacts API documentation.

[Rest API] Get API Lifetime Message Statistics

Returns aggregated statistics for API messages sent over the lifetime of the account.

This endpoint retrieves lifetime message counters from the Mailjet /v3/REST/statcounters endpoint, filtered to CounterSource=APIKey, CounterResolution=Lifetime, and CounterTiming=Message.

For details on response fields, see the Mailjet statistics API documentation.

[Rest API] List Campaigns

Returns a list of all campaigns in the Mailjet account.

This endpoint retrieves records from the Mailjet /v3/REST/campaign endpoint. Nexla automatically paginates through the results using offset-based paging.

For details on response fields, see the Mailjet campaigns API documentation.

[Rest API] List Messages

Returns a list of all messages sent through the Mailjet account, including message subjects.

This endpoint retrieves records from the Mailjet /v3/REST/message endpoint with ShowSubject=true. Nexla automatically paginates through the results using offset-based paging.

For details on response fields, see the Mailjet messages API documentation.

[Rest API] List Recipients

Returns a list of all recipients across contact lists in the Mailjet account.

This endpoint retrieves records from the Mailjet /v3/REST/listrecipient endpoint. Nexla automatically paginates through the results using offset-based paging.

For details on response fields, see the Mailjet recipients API documentation.

[Rest API] Retrieve bounce statistics for deliverability monitoring

Retrieve bounce statistics for deliverability monitoring.

This endpoint retrieves records from the Mailjet /v3/REST/bouncestatistics endpoint as a single, non-paginated request.

For details on response fields, see the Mailjet statistics API documentation.

[Rest API] Retrieve Statistics with Filters

Retrieve statistics with arbitrary CounterSource, CounterResolution, and CounterTiming filters.

This endpoint retrieves records from the Mailjet /v3/REST/statcounters endpoint as a single, non-paginated request. Supply your own filter parameters to control which counters are returned.

For details on the available filters and response fields, see the Mailjet statistics API documentation.

[Rest API] List suppressed (blocked/unsubscribed) addresses

List suppressed (blocked/unsubscribed) addresses.

This endpoint retrieves records from the Mailjet /v3/REST/suppressionlist endpoint as a single, non-paginated request.

For details on response fields, see the Mailjet statistics API documentation.

[Rest API] List Senders

Returns a paginated list of all validated sender email addresses configured for the Mailjet account.

This endpoint retrieves records from the Mailjet /v3/REST/sender endpoint. Nexla automatically paginates through the results using offset-based paging.

For details on response fields, see the Mailjet sender API documentation.

[Rest API] List Templates

Returns a paginated list of email templates stored in the Mailjet account, supporting filtering by owner type.

This endpoint retrieves records from the Mailjet /v3/REST/template endpoint. Nexla automatically paginates through the results using offset-based paging.

For details on response fields, see the Mailjet template API documentation.

Once the selected endpoint template has been configured, click the Test button to the right of the endpoint selection menu to retrieve a sample of the data that will be fetched. Sample data will be displayed in the Endpoint Test Result panel on the right, allowing you to verify that the source is configured correctly before saving.

Manual configuration

Mailjet data sources can also be manually configured to ingest data from any valid Mailjet API endpoint, including endpoints not covered by the pre-built templates, chained API calls, or custom request parameters. Select the Advanced tab at the top of the configuration screen, and follow the instructions in Connect to Any API to configure the API method, endpoint URL, date/time and lookup macros, path to data, metadata, and request headers.

Once all of the relevant settings have been configured, click the Create button in the upper right corner of the screen to save and create the new Mailjet data source. Nexla will now begin ingesting data from the configured endpoint and will organize any data that it finds into one or more Nexsets.

Use as a destination

Click the + icon on the Nexset that will be sent to the Mailjet destination, and select the Send to Destination option from the menu. Select the Mailjet Mail connector from the list of available destination connectors, then select the credential that will be used to connect to Mailjet, and click Next; or, create a new Mailjet Mail credential for use in this flow.

Endpoint templates

Nexla provides pre-built templates that can be used to rapidly configure destinations to send data to common Mailjet endpoints. Select the endpoint to which data will be sent from the Endpoint pulldown menu. Then, click on the template in the list below to expand it, and follow the instructions to configure additional endpoint settings.

[Rest API] Send transactional or marketing emails via Mailjet Send API

Send transactional or marketing emails via Mailjet Send API v3.1.

This endpoint sends each record from your Nexset as a JSON payload in a POST request to the Mailjet /v3.1/send endpoint. The payload must match the structure expected by the Mailjet Send API v3.1.

For request body formats and message properties, see the Mailjet Send API documentation.

[Rest API] Create a new contact in Mailjet

Create a new contact in Mailjet.

This endpoint sends each record from your Nexset as a JSON payload in a POST request to the Mailjet /v3/REST/contact endpoint.

For request body formats and contact properties, see the Mailjet contact API documentation.

[Rest API] Create a new marketing campaign (newsletter)

Create a new marketing campaign (newsletter).

This endpoint sends each record from your Nexset as a JSON payload in a POST request to the Mailjet /v3/REST/campaign endpoint.

For request body formats and campaign draft properties, see the Mailjet campaign drafts API documentation.

[Rest API] Send or schedule a campaign draft

Send or schedule a campaign draft.

• This endpoint requires a Campaign Id — the ID of the campaign draft to send or schedule. Provide it when configuring the endpoint.

This endpoint sends a POST request to the Mailjet /v3/REST/campaigndraft/{id}/send endpoint, where the ID is taken from the Campaign Id parameter. Each record from your Nexset is sent as the JSON request body.

For details, see the Mailjet send campaign drafts guide.

[Rest API] Create a new contact list

Create a new contact list.

This endpoint sends each record from your Nexset as a JSON payload in a POST request to the Mailjet /v3/REST/contactslist endpoint.

For request body formats and contact list properties, see the Mailjet contact list API documentation.

[Rest API] Subscribe or unsubscribe contacts to/from a list in bulk

Subscribe or unsubscribe contacts to/from a list in bulk.

• This endpoint requires a List Id — the ID of the contact list to manage. Provide it when configuring the endpoint.

This endpoint sends a POST request to the Mailjet /v3/REST/contactslist/{id}/managecontacts endpoint, where the ID is taken from the List Id parameter. Each record from your Nexset is sent as the JSON request body.

For request body formats, see the Mailjet bulk contact management documentation.

[Rest API] Register a webhook for real-time email events (open, click, bounce, spam, unsubscribe)

Register a webhook for real-time email events (open, click, bounce, spam, unsubscribe).

This endpoint sends each record from your Nexset as a JSON payload in a POST request to the Mailjet /v3/REST/eventcallbackurl endpoint to register an event callback (webhook) URL.

For request body formats and supported event types, see the Mailjet webhooks guide.

[Rest API] Update an existing contact's properties

Update an existing contact's properties.

• This endpoint requires a Contact Id — the ID of the contact to update. Provide it when configuring the endpoint.

This endpoint sends a PUT request to the Mailjet /v3/REST/contact/{id} endpoint, where the ID is taken from the Contact Id parameter. Each record from your Nexset is sent as the JSON request body.

For request body formats and contact properties, see the Mailjet contact API documentation.

[Rest API] Delete a contact (GDPR erasure / data cleanup)

Delete a contact (GDPR erasure / data cleanup).

• This endpoint requires a Contact Id — the ID of the contact to delete. Provide it when configuring the endpoint.

This endpoint sends a DELETE request to the Mailjet /v3/REST/contact/{id} endpoint, where the ID is taken from the Contact Id parameter. This action permanently removes the contact and cannot be undone.

For details, see the Mailjet contact API documentation.

Manual configuration

Mailjet destinations can also be manually configured to send data to any valid Mailjet API endpoint. Select the Advanced tab at the top of the configuration screen, and follow the instructions in Connect to Any API to configure the API method, data format, endpoint URL, request headers, attribute exclusions, record batching, and response webhooks.

Mailjet APIs expect JSON payloads for write operations. For update operations, include the ID of the object to be updated at the end of the URL.

Save & activate

Once all endpoint settings have been configured, click the Done button in the upper right corner of the screen to save and create the destination. To send the data to the configured Mailjet endpoint, open the destination resource menu, and select Activate.

The Nexset data will not be sent to the Mailjet endpoint until the destination is activated. Destinations can be activated immediately or at a later time, providing full control over data movement.