Mailjet REST API Client

Warnings

• breaking Support for Python 3.9 was dropped in mailjet-rest v1.5.0. Ensure your environment uses Python 3.10 or newer for full compatibility and continued updates.
  Fix: Upgrade your Python environment to 3.10 or a later supported version.
• gotcha Prior to v1.5.0, users experienced `csvimport error 'List index (0) out of bounds'` when attempting CSV imports. This was fixed in v1.5.0.
  Fix: Upgrade to mailjet-rest v1.5.0 or later to resolve CSV import issues.
• gotcha Incorrect Mailjet API keys (public and private) will lead to `401 Unauthorized` errors. Always double-check your credentials and ensure they are active.
  Fix: Verify your API keys on your Mailjet account dashboard and ensure they are correctly configured in your application.
• gotcha Mailjet API PUT requests behave like PATCH requests, meaning they only update the specified properties and do not overwrite the entire resource. Other existing properties will remain unchanged.
  Fix: Be aware that PUT operations are partial updates. Only include the fields you intend to modify in your payload.
• gotcha Mailjet's API has rate limits (e.g., typically 30 calls/second for some endpoints). Exceeding these limits will result in `429 Too Many Requests` errors.
  Fix: Implement retry logic with exponential backoff and consider using batch sending for high volumes of emails to stay within rate limits.
• gotcha The `Recipients` property in the email payload sends a separate, individualized message to each recipient without revealing other recipients. In contrast, `To`, `Cc`, and `Bcc` will show other recipients as expected in a standard email client. Mixing `Recipients` with `To`, `Cc`, or `Bcc` is not allowed.
  Fix: Choose either `Recipients` for individual, hidden messages or `To`/`Cc`/`Bcc` for group visibility, but do not combine them in a single send request.

Install

• pip install mailjet-rest Install stable version

Imports

• Client

  from mailjet_rest import Client

Quickstart

This quickstart demonstrates how to initialize the Mailjet client and send a basic email. Ensure your Mailjet API public and private keys are set as environment variables (MJ_APIKEY_PUBLIC, MJ_APIKEY_PRIVATE) or replaced with actual keys. The 'From' email address must be a verified sender in your Mailjet account. The example uses the v3.1 Send API for more robust messaging features.

import os
from mailjet_rest import Client

# Mailjet API keys can be found at https://app.mailjet.com/account/api_keys
# It's highly recommended to store these in environment variables.
api_key = os.environ.get('MJ_APIKEY_PUBLIC', 'your_public_api_key_here')
api_secret = os.environ.get('MJ_APIKEY_PRIVATE', 'your_private_api_secret_here')

# Initialize the Mailjet client, specifying API version v3.1 for the Send API.
mailjet = Client(auth=(api_key, api_secret), version='v3.1')

# Prepare the email data
data = {
  'Messages': [
    {
      "From": {
        "Email": "pilot@mailjet.com", # Must be a verified sender in your Mailjet account
        "Name": "Mailjet Pilot"
      },
      "To": [
        {
          "Email": "passenger@mailjet.com",
          "Name": "Passenger 1"
        }
      ],
      "Subject": "Your email flight plan!",
      "TextPart": "Dear passenger, welcome to Mailjet! May the delivery force be with you!",
      "HTMLPart": "<h3>Dear passenger, welcome to <a href=\"https://www.mailjet.com/\">Mailjet</a>!</h3><br />May the delivery force be with you!"
    }
  ]
}

# Send the email
result = mailjet.send.create(data=data)

# Print the response status and content
print(f"Status Code: {result.status_code}")
print(f"Response: {result.json()}")

# Check for common API errors
if result.status_code >= 400:
    print(f"Error details: {result.json()}")