Send email with Mandrill through Courier

Prerequisites

A Mailchimp Transactional (Mandrill) account
A Mandrill API key

Setup

Create a Mandrill API key

In Mailchimp Transactional, follow the quick start to create an API key.

Configure in Courier

Open the in Courier, enter your API key, From Address, and From Name, 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 Mandrill’s Messages API. This example adds an attachment.

const { requestId } = await courier.send.message({
  message: {
    template: "nt_01kx4h2jdafq8bk9aftxak4b40",
    to: {
      email: "sarah@acme-corp.com",
    },
    providers: {
      mandrill: {
        override: {
          body: {
            message: {
              from_email: "support@acme-corp.com",
              subject: "Hi there",
              from_name: "Rod",
              attachments: [
                {
                  type: "text/plain",
                  name: "myfile.txt",
                  content: "ZXhhbXBsZSBmaWxl",
                },
              ],
            },
          },
        },
      },
    },
  },
});

response = client.send.message(
    message={
        "template": "nt_01kx4h2jdafq8bk9aftxak4b40",
        "to": {
            "email": "sarah@acme-corp.com",
        },
        "providers": {
            "mandrill": {
                "override": {
                    "body": {
                        "message": {
                            "from_email": "support@acme-corp.com",
                            "subject": "Hi there",
                            "from_name": "Rod",
                            "attachments": [
                                {
                                    "type": "text/plain",
                                    "name": "myfile.txt",
                                    "content": "ZXhhbXBsZSBmaWxl",
                                },
                            ],
                        },
                    },
                },
            },
        },
    },
)

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": {
        "mandrill": {
          "override": {
            "body": {
              "message": {
                "from_email": "support@acme-corp.com",
                "subject": "Hi there",
                "from_name": "Rod",
                "attachments": [
                  {
                    "type": "text/plain",
                    "name": "myfile.txt",
                    "content": "ZXhhbXBsZSBmaWxl"
                  }
                ]
              }
            }
          }
        }
      }
    }
  }'

response = courier.send_.message(
  message: {
    template: "nt_01kx4h2jdafq8bk9aftxak4b40",
    to: {
      email: "sarah@acme-corp.com"
    },
    providers: {
      mandrill: {
        override: {
          body: {
            message: {
              from_email: "support@acme-corp.com",
              subject: "Hi there",
              from_name: "Rod",
              attachments: [
                {
                  type: "text/plain",
                  name: "myfile.txt",
                  content: "ZXhhbXBsZSBmaWxl"
                }
              ]
            }
          }
        }
      }
    }
  }
)

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{
			"mandrill": shared.MessageProvidersTypeParam{
				Override: map[string]any{
					"body": map[string]any{
						"message": map[string]any{
							"from_email": "support@acme-corp.com",
							"subject": "Hi there",
							"from_name": "Rod",
							"attachments": []any{
								map[string]any{
									"type": "text/plain",
									"name": "myfile.txt",
									"content": "ZXhhbXBsZSBmaWxl",
								},
							},
						},
					},
				},
			},
		},
	},
})

SendMessageParams params = SendMessageParams.builder()
    .message(SendMessageParams.Message.builder()
        .to(UserRecipient.builder().email("sarah@acme-corp.com").build())
        .template("nt_01kx4h2jdafq8bk9aftxak4b40")
        .providers(MessageProviders.builder()
            .putAdditionalProperty("mandrill", JsonValue.from(java.util.Map.of("override", java.util.Map.of(
                    "body", java.util.Map.of(
                        "message", java.util.Map.of(
                            "from_email", "support@acme-corp.com",
                            "subject", "Hi there",
                            "from_name", "Rod",
                            "attachments", java.util.List.of(
                                java.util.Map.of(
                                    "type", "text/plain",
                                    "name", "myfile.txt",
                                    "content", "ZXhhbXBsZSBmaWxl"
                                )
                            )
                        )
                    )
                ))))
            .build())
        .build())
    .build();
SendMessageResponse response = client.send().message(params);

$response = $client->send->message(
  message: [
    'template' => 'nt_01kx4h2jdafq8bk9aftxak4b40',
    'to' => [
      'email' => 'sarah@acme-corp.com',
    ],
    'providers' => [
      'mandrill' => [
        'override' => [
          'body' => [
            'message' => [
              'from_email' => 'support@acme-corp.com',
              'subject' => 'Hi there',
              'from_name' => 'Rod',
              'attachments' => [
                [
                  'type' => 'text/plain',
                  'name' => 'myfile.txt',
                  'content' => 'ZXhhbXBsZSBmaWxl',
                ],
              ],
            ],
          ],
        ],
      ],
    ],
  ],
);

SendMessageParams parameters = new()
{
    Message = new()
    {
        To = new UserRecipient { Email = "sarah@acme-corp.com" },
        Template = "nt_01kx4h2jdafq8bk9aftxak4b40",
        Providers = new Dictionary<string, MessageProvidersType>()
        {
            {
                "mandrill",
                new()
                {
                    Override = JsonSerializer.Deserialize<Dictionary<string, JsonElement>>(
                        """
                        {
                          "body": {
                            "message": {
                              "from_email": "support@acme-corp.com",
                              "subject": "Hi there",
                              "from_name": "Rod",
                              "attachments": [
                                {
                                  "type": "text/plain",
                                  "name": "myfile.txt",
                                  "content": "ZXhhbXBsZSBmaWxl"
                                }
                              ]
                            }
                          }
                        }
                        """
                    ),
                }
            },
        },
    },
};

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 '{"mandrill": {"override": {"body": {"message": {"from_email": "support@acme-corp.com", "subject": "Hi there", "from_name": "Rod", "attachments": [{"type": "text/plain", "name": "myfile.txt", "content": "ZXhhbXBsZSBmaWxl"}]}}}}}'

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

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

Template import

Import your Mandrill templates from the .

Enter your Mandrill credentials on the configuration page to load your saved templates.

Templates ready for import appear as checkboxes.

Troubleshooting

Check the to debug provider errors. For anything else, contact Courier Support.

Mandrill click tracking not working

Three likely causes:

Click tracking is off.
The URL is too long, so Mandrill disabled click tracking.
The clicks are recorded but not updated in real time.

Solution Check whether click tracking is enabled:

Log into Mandrill

Open Sending defaults

Go to Settings, then Sending defaults.

Check the Track Clicks setting

Set the “Track Clicks” dropdown to anything other than “No click tracking”.

Mandrill tracks opens and clicks in real time, but status updates can lag. Delays run from a few minutes to much longer, such as when their system is under load. for clicks on your Templates.

Mandrill BCC not working

Mandrill is ignoring the BCC headers. Solution

Use the to field rather than the bcc field, and set X-MC-PreserveRecipients to false.
Or put the BCC address in the to field with its type set to bcc. Add preserve_recipients: true under the message section, as below.

{
   "to":[
      {
         "email":"sarah@acme-corp.com",
         "name":"Sarah Bennett",
         "type":"to"
      },
      {
         "email":"archive@acme-corp.com",
         "name":"Archive",
         "type":"bcc"
      },
      {
         "email":"ops@acme-corp.com",
         "name":"Ops",
         "type":"bcc"
      }
   ]
}

For more on X-MC-PreserveRecipients, see Mailchimp’s SMTP headers documentation

Mandrill CC emails not present

Pass CC fields to Mandrill’s API or through an API override. As with BCC, set preserve_recipients to true in the override request. Without it, CC emails will not be sent. Solution

{
  // ... rest of message definition
   "providers":{
      "mandrill":{
         "override":{
            "body":{
               "message":{
                  "preserve_recipients":true, //This setting must be set to true when passing CC recipients.
                  "attachments":[
                     {
                        "name":"Top Secret",
                        "content":"ZXhhbXBsZSBmaWxl",
                        "type":"application/pdf"
                     }
                  ]
               }
            }
         }
      }
   }
}

Mandrill merge vars not working

Merge variables usually fail because of how they are nested. Solution Nest the variables inside the message struct, as below.

var message = {
    to: "sarah@acme-corp.com",
    mandrillOptions: {
        template_name: 'template1',
        template_content: [
        ],
        message: {
            "merge": true,
            "merge_language": "handlebars",
            "global_merge_vars": [{
                    "name": "fname",
                    "content": "Sample"
                },
                {
                    "name": "email",
                    "content": "sarah@acme-corp.com"
                }
            ]
        }
    }
};

Provider details

mandrill

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 Mandrill through Courier

Prerequisites

Setup

Overrides

Template import

Troubleshooting

Mandrill click tracking not working

Mandrill BCC not working

Mandrill CC emails not present

Mandrill merge vars not working

Provider details

Send to a specific provider

​Prerequisites

​Setup

​Overrides

​Template import

​Troubleshooting

​Mandrill click tracking not working

​Mandrill BCC not working

​Mandrill CC emails not present

​Mandrill merge vars not working

​Provider details

Send to a specific provider

Prerequisites

Setup

Overrides

Template import

Troubleshooting

Mandrill click tracking not working

Mandrill BCC not working

Mandrill CC emails not present

Mandrill merge vars not working

Provider details