Send email with Mailjet through Courier

Prerequisites

Setup

Get your Mailjet API keys

In Mailjet, open API key management and copy the API key and secret key.

Configure in Courier

Open the in Courier, enter both keys and your From Address, then save.

Addressing a recipient and sending are the same on every email provider, so they are documented once: and .

Overrides

covers the two levels and which one wins. lists the fields every email provider takes. Use a provider override to change what Courier sends to Mailjet’s Send API. This example adds an attachment.

const { requestId } = await courier.send.message({
  message: {
    template: "nt_01kx4h2jdafq8bk9aftxak4b40",
    to: {
      email: "sarah@acme-corp.com",
    },
    providers: {
      mailjet: {
        override: {
          body: {
            Attachments: [
              {
                ContentType: "text/plain",
                Filename: "test.txt",
                content: "VGhpcyBpcyB5b3VyIGF0dGFjaGVkIGZpbGUhISEK",
              },
            ],
          },
        },
      },
    },
  },
});

response = client.send.message(
    message={
        "template": "nt_01kx4h2jdafq8bk9aftxak4b40",
        "to": {
            "email": "sarah@acme-corp.com",
        },
        "providers": {
            "mailjet": {
                "override": {
                    "body": {
                        "Attachments": [
                            {
                                "ContentType": "text/plain",
                                "Filename": "test.txt",
                                "content": "VGhpcyBpcyB5b3VyIGF0dGFjaGVkIGZpbGUhISEK",
                            },
                        ],
                    },
                },
            },
        },
    },
)

curl -X POST https://api.courier.com/send \
  -H "Authorization: Bearer $COURIER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "message": {
      "template": "nt_01kx4h2jdafq8bk9aftxak4b40",
      "to": {
        "email": "sarah@acme-corp.com"
      },
      "providers": {
        "mailjet": {
          "override": {
            "body": {
              "Attachments": [
                {
                  "ContentType": "text/plain",
                  "Filename": "test.txt",
                  "content": "VGhpcyBpcyB5b3VyIGF0dGFjaGVkIGZpbGUhISEK"
                }
              ]
            }
          }
        }
      }
    }
  }'

response = courier.send_.message(
  message: {
    template: "nt_01kx4h2jdafq8bk9aftxak4b40",
    to: {
      email: "sarah@acme-corp.com"
    },
    providers: {
      mailjet: {
        override: {
          body: {
            Attachments: [
              {
                ContentType: "text/plain",
                Filename: "test.txt",
                content: "VGhpcyBpcyB5b3VyIGF0dGFjaGVkIGZpbGUhISEK"
              }
            ]
          }
        }
      }
    }
  }
)

response, err := client.Send.Message(context.TODO(), courier.SendMessageParams{
	Message: courier.SendMessageParamsMessage{
		To: courier.SendMessageParamsMessageToUnion{
			OfUserRecipient: &shared.UserRecipientParam{
				Email: courier.String("sarah@acme-corp.com"),
			},
		},
		Template: courier.String("nt_01kx4h2jdafq8bk9aftxak4b40"),
		Providers: shared.MessageProvidersParam{
			"mailjet": shared.MessageProvidersTypeParam{
				Override: map[string]any{
					"body": map[string]any{
						"Attachments": []any{
							map[string]any{
								"ContentType": "text/plain",
								"Filename": "test.txt",
								"content": "VGhpcyBpcyB5b3VyIGF0dGFjaGVkIGZpbGUhISEK",
							},
						},
					},
				},
			},
		},
	},
})

SendMessageParams params = SendMessageParams.builder()
    .message(SendMessageParams.Message.builder()
        .to(UserRecipient.builder().email("sarah@acme-corp.com").build())
        .template("nt_01kx4h2jdafq8bk9aftxak4b40")
        .providers(MessageProviders.builder()
            .putAdditionalProperty("mailjet", JsonValue.from(java.util.Map.of("override", java.util.Map.of(
                    "body", java.util.Map.of(
                        "Attachments", java.util.List.of(
                            java.util.Map.of(
                                "ContentType", "text/plain",
                                "Filename", "test.txt",
                                "content", "VGhpcyBpcyB5b3VyIGF0dGFjaGVkIGZpbGUhISEK"
                            )
                        )
                    )
                ))))
            .build())
        .build())
    .build();
SendMessageResponse response = client.send().message(params);

$response = $client->send->message(
  message: [
    'template' => 'nt_01kx4h2jdafq8bk9aftxak4b40',
    'to' => [
      'email' => 'sarah@acme-corp.com',
    ],
    'providers' => [
      'mailjet' => [
        'override' => [
          'body' => [
            'Attachments' => [
              [
                'ContentType' => 'text/plain',
                'Filename' => 'test.txt',
                'content' => 'VGhpcyBpcyB5b3VyIGF0dGFjaGVkIGZpbGUhISEK',
              ],
            ],
          ],
        ],
      ],
    ],
  ],
);

SendMessageParams parameters = new()
{
    Message = new()
    {
        To = new UserRecipient { Email = "sarah@acme-corp.com" },
        Template = "nt_01kx4h2jdafq8bk9aftxak4b40",
        Providers = new Dictionary<string, MessageProvidersType>()
        {
            {
                "mailjet",
                new()
                {
                    Override = JsonSerializer.Deserialize<Dictionary<string, JsonElement>>(
                        """
                        {
                          "body": {
                            "Attachments": [
                              {
                                "ContentType": "text/plain",
                                "Filename": "test.txt",
                                "content": "VGhpcyBpcyB5b3VyIGF0dGFjaGVkIGZpbGUhISEK"
                              }
                            ]
                          }
                        }
                        """
                    ),
                }
            },
        },
    },
};

var response = await client.Send.Message(parameters);

courier send message \
  --api-key "$COURIER_API_KEY" \
  --message.to '{"email": "sarah@acme-corp.com"}' \
  --message.template nt_01kx4h2jdafq8bk9aftxak4b40 \
  --message.providers '{"mailjet": {"override": {"body": {"Attachments": [{"ContentType": "text/plain", "Filename": "test.txt", "content": "VGhpcyBpcyB5b3VyIGF0dGFjaGVkIGZpbGUhISEK"}]}}}}'

With Courier MCP, send my template to sarah@acme-corp.com with an attachment through Mailjet.

Overrides are deep-merged into the request. Fields you set replace their counterparts, and everything you leave out is still sent. Mailjet’s full field list is in the Mailjet Send API docs.

Provider details

mailjet

Courier recommends routing to the channel. Naming this key in routing.channels instead is supported, and sends through just this provider.

Send to a specific provider

When that is worth doing, and what you give up: failover, channel priority, and providers you add later.

Get started

Available integrations

Send email with Mailjet through Courier

Prerequisites

Setup

Overrides

Provider details

Send to a specific provider

​Prerequisites

​Setup

​Overrides

​Provider details

Send to a specific provider

Prerequisites

Setup

Overrides

Provider details