Mandrill

Mandrill is a transactional email API for MailChimp users. It's reliable, powerful, and ideal for sending data driven emails, including targeted e-commerce and personalized one-to-one messages.

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
Flow Premium All Flow regions except the following:
     -   US Government (GCC)
PowerApps Premium All PowerApps regions except the following:
     -   US Government (GCC)

Creating a connection

To connect your account, you will need the following information:

Name Type Description
Mandrill API Key securestring

Mandrill API Key

Throttling Limits

Name Calls Renewal Period
API calls per connection120060 seconds

Actions

Current user info

Return the information about the API-connected user.

List scheduled message

Queries your scheduled emails.

Send mail

Send a new transactional message through Mandrill.

Send mail (V2)

Send a new transactional message through Mandrill.

Current user info

Return the information about the API-connected user.

Returns

the user information including username, key, reputation, quota, and historical sending stats

Body
UserInfo

List scheduled message

Queries your scheduled emails.

Parameters

Name Key Required Type Description
To
To string

Optional recipient email address to restrict results to

Returns

Send mail

Send a new transactional message through Mandrill.

Parameters

Name Key Required Type Description
HTML Text
html string

Full HTML content to be sent

Text content of the message
text True string

Full text content to be sent

Subject
subject True string

Message subject

From Email
from_email True string

Sender email address

From Name
from_name string

Sender email name

Email
email True string

Email address of the recipient

Name
name string

Display name of the recipient

Send As
type string

Send type (to, cc, bcc)

Extra headers
headers string

Extra headers to add to the message (most headers are allowed)

Is this message Important (true/false)?
important boolean

Whether or not this message is important, and should be delivered ahead of non-important messages

Track when message opens (true/false)?
track_opens boolean

Whether or not to turn on open tracking for the message

Track clicks for this message (true/false)?
track_clicks boolean

Whether or not to turn on click tracking for the message

Fill text message if not present (true/false)?
auto_text boolean

Whether or not to automatically generate a text part for messages that are not given text

Fill HTML message if not present (true/false)?
auto_html boolean

Whether or not to automatically generate an HTML part for messages that are not given HTML

Inline CSS Styles in Html message (true/false)?
inline_css boolean

Whether or not to automatically inline all CSS styles provided in the message HTML - only for HTML documents less than 256KB in size

Strip query string from URL in aggregated data (true/false)?
url_strip_qs boolean

Whether or not to strip the query string from URLs when aggregating tracked URL data

Show all recipients in 'To' line (true/false)?
preserve_recipients boolean

Whether or not to expose all recipients in to "To" header for each email

Remove content logging (true/false)?
view_content_link boolean

Whether or not to log content. Set to false to remove content logging for sensitive emails

Optional BCC address
bcc_address string

Optional address to receive an exact copy of each recipient's email

Custom domaing for tracking
tracking_domain string

Custom domain to use for tracking opens and clicks instead of mandrillapp.com

Tags
Tags string

Full HTML content to be sent

MIME Type
type string

MIME type of the attachment

File Name
name string

File name of the attachment

Content
content byte

Content of the attachment

Send At
send_at string

When this message should be sent as a UTC timestamp in YYYY-MM-DD HH:MM:SS format. If you specify a time in the past, the message will be sent immediately. An additional fee applies for scheduled email, and this feature is only available to accounts with a positive balance.

Enable async (true/false)?
async boolean

Enable a background sending mode that is optimized for bulk sending

Dedicated Ip Pool name
ip_pool string

Name of the dedicated ip pool that should be used to send the message

Returns

Send mail (V2)

Send a new transactional message through Mandrill.

Parameters

Name Key Required Type Description
Content of the message
html html

Full content to be sent

Subject
subject True string

Message subject

From Email
from_email True string

Sender email address

From Name
from_name string

Sender email name

Email
email True string

Email address of the recipient

Name
name string

Display name of the recipient

Send As
type string

Send type (to, cc, bcc)

Extra headers
headers string

Extra headers to add to the message (most headers are allowed)

Is this message Important (true/false)?
important boolean

Whether or not this message is important, and should be delivered ahead of non-important messages

Track when message opens (true/false)?
track_opens boolean

Whether or not to turn on open tracking for the message

Track clicks for this message (true/false)?
track_clicks boolean

Whether or not to turn on click tracking for the message

Fill text message if not present (true/false)?
auto_text boolean

Whether or not to automatically generate a text part for messages that are not given text

Inline CSS Styles in Html message (true/false)?
inline_css boolean

Whether or not to automatically inline all CSS styles provided in the message HTML - only for HTML documents less than 256KB in size

Strip query string from URL in aggregated data (true/false)?
url_strip_qs boolean

Whether or not to strip the query string from URLs when aggregating tracked URL data

Show all recipients in 'To' line (true/false)?
preserve_recipients boolean

Whether or not to expose all recipients in to "To" header for each email

Remove content logging (true/false)?
view_content_link boolean

Whether or not to log content. Set to false to remove content logging for sensitive emails

Optional BCC address
bcc_address string

Optional address to receive an exact copy of each recipient's email

Custom domaing for tracking
tracking_domain string

Custom domain to use for tracking opens and clicks instead of mandrillapp.com

Tags
Tags string

Full content to be sent

MIME Type
type string

MIME type of the attachment

File Name
name string

File name of the attachment

Content
content byte

Content of the attachment

Send At
send_at string

When this message should be sent as a UTC timestamp in YYYY-MM-DD HH:MM:SS format. If you specify a time in the past, the message will be sent immediately. An additional fee applies for scheduled email, and this feature is only available to accounts with a positive balance.

Enable async (true/false)?
async boolean

Enable a background sending mode that is optimized for bulk sending

Dedicated Ip Pool name
ip_pool string

Name of the dedicated ip pool that should be used to send the message

Returns

Definitions

UserInfo

the user information including username, key, reputation, quota, and historical sending stats

Name Path Type Description
User Name
username string

Username of the user (used for SMTP authentication)

Created at
created_at string

Date and time that the user's Mandrill account was created as a UTC string in YYYY-MM-DD HH:MM:SS format

Public id
public_id string

Unique, permanent identifier for this user

Reputation
reputation integer

Reputation of the user on a scale from 0 to 100, with 75 generally being a "good" reputation

Hourly Quota
hourly_quota integer

Maximum number of emails Mandrill will deliver for this user each hour. Any emails beyond that will be accepted and queued for later delivery. Users with higher reputations will have higher hourly quotas

Backlog
backlog integer

Number of emails that are queued for delivery due to exceeding your monthly or hourly quotas

stats
stats Stats

aggregate summary of the account's sending stats

Stats

aggregate summary of the account's sending stats

Name Path Type Description
today
today StatStruct

Struct to hold stat information, this struct is shared across stats for today, last_7_days, last_30_days, last_60_days, last_90_days and all_time

last_7_days
last_7_days StatStruct

Struct to hold stat information, this struct is shared across stats for today, last_7_days, last_30_days, last_60_days, last_90_days and all_time

last_30_days
last_30_days StatStruct

Struct to hold stat information, this struct is shared across stats for today, last_7_days, last_30_days, last_60_days, last_90_days and all_time

last_60_days
last_60_days StatStruct

Struct to hold stat information, this struct is shared across stats for today, last_7_days, last_30_days, last_60_days, last_90_days and all_time

last_90_days
last_90_days StatStruct

Struct to hold stat information, this struct is shared across stats for today, last_7_days, last_30_days, last_60_days, last_90_days and all_time

all_time
all_time StatStruct

Struct to hold stat information, this struct is shared across stats for today, last_7_days, last_30_days, last_60_days, last_90_days and all_time

StatStruct

Struct to hold stat information, this struct is shared across stats for today, last_7_days, last_30_days, last_60_days, last_90_days and all_time

Name Path Type Description
Sent
sent integer

Number of emails sent for this user

Hard Bounces
hard_bounces integer

Number of emails hard bounced for this user

Soft Bounces
soft_bounces integer

Number of emails soft bounced for this user

Rejects
rejects integer

Number of emails rejected for sending this user

Complaints
complaints integer

Number of spam complaints for this user

Unsubscribes
unsubs integer

Number of unsubscribes for this user

Unique Opens
unique_opens integer

Number of times emails have been opened for this user

Clicks
clicks integer

Number of URLS that have been clicked for this user so far today

Unique Clicks
unique_clicks integer

Number of unique clicks for emails sent for this user

SendMessageResponse

Information for the message for each recipient containing the key "email" with the email address, and details of the message status for that recipient

Name Path Type Description
Email
email string

Email address of the recipient

Sending Status
status string

Sending status of the recipient - either "sent", "queued", "scheduled", "rejected", or "invalid"

Reject Reason
reject_reason string

Reason for the rejection if the recipient status is "rejected" - one of "hard-bounce", "soft-bounce", "spam", "unsub", "custom", "invalid-sender", "invalid", "test-mode-limit", "unsigned", or "rule

Message ID
_id string

message's unique id

ListScheduledInfo

Information about a specific smtp event

Name Path Type Description
Recipient's Email
email string

Email address of the recipient

Recipient's Status
status string

Sending status of the recipient - either "sent", "queued", "scheduled", "rejected", or "invalid"

Rejection Reason
reject_reason string

Reason for the rejection if the recipient status is "rejected" - one of "hard-bounce", "soft-bounce", "spam", "unsub", "custom", "invalid-sender", "invalid", "test-mode-limit", "unsigned", or "rule"

Message ID
_id string

Message's unique id