Documentation

__construct()

Parameters

$master : Client

cancelScheduled()

Cancels a scheduled email.

Parameters

$id : string

a scheduled email id, as returned by any of the messages/send calls or messages/list-scheduled

content()

Get the full content of a recently sent message.

Parameters

$id : string

the unique id of the message to get - passed as the "_id" field in webhooks, send calls, or search calls

info()

Get the information for a single recently sent message.

Parameters

$id : string

the unique id of the message to get - passed as the "_id" field in webhooks, send calls, or search calls

listScheduled()

Queries your scheduled emails.

Parameters

$to : string = null

an optional recipient address to restrict results to

parse()

Parse the full MIME document for an email message, returning the content of the message broken into its constituent pieces.

Parameters

$rawMessage : string

the full MIME document of an email message

reschedule()

Reschedules a scheduled email.

Parameters

$id : string

a scheduled email id, as returned by any of the messages/send calls or messages/list-scheduled

$sendAt : string

the new UTC timestamp when the message should sent. Mandrill can't time travel, so if you specify a time in past the message will be sent immediately

search()

Search recently sent messages and optionally narrow by date range, tags, senders, and API keys. If no date range is specified, results within the last 7 days are returned. This method may be called up to 20 times per minute. If you need the data more often, you can use <a href="/api/docs/messages.html#method=info">/messages/info.json</a> to get the information for a single message, or <a href="http://help.mandrill.com/entries/21738186-Introduction-to-Webhooks">webhooks</a> to push activity to your own application for querying.

Parameters

$query : string = '*'

search terms to find matching messages

$dateFrom : string = null

start date

$dateTo : string = null

end date

$tags : array<string|int, mixed> = null

an array of tag names to narrow the search to, will return messages that contain ANY of the tags

$senders : array<string|int, mixed> = null

an array of sender addresses to narrow the search to, will return messages sent by ANY of the senders

$apiKeys : array<string|int, mixed> = null

an array of API keys to narrow the search to, will return messages sent by ANY of the keys

$limit : int = 100

the maximum number of results to return, defaults to 100, 1000 is the maximum

searchTimeSeries()

Search the content of recently sent messages and return the aggregated hourly stats for matching messages.

Parameters

$query : string = '*'

the search terms to find matching messages for

$dateFrom : string = null

start date

$dateTo : string = null

end date

$tags : array<string|int, mixed> = null

an array of tag names to narrow the search to, will return messages that contain ANY of the tags

$senders : array<string|int, mixed> = null

an array of sender addresses to narrow the search to, will return messages sent by ANY of the senders

send()

Send a new transactional message through Mandrill.

Parameters

$message : struct

the information on the message to send

• html string the full HTML content to be sent
• text string optional full text content to be sent
• subject string the message subject
• from_email string the sender email address.
• from_name string optional from name to be used
• to array an array of recipient information.
• to[] struct a single recipient's information.
• email string the email address of the recipient
• name string the optional display name to use for the recipient
• type string the header type to use for the recipient, defaults to "to" if not provided
• headers struct optional extra headers to add to the message (most headers are allowed)
• important boolean whether or not this message is important, and should be delivered ahead of non-important messages
• track_opens boolean whether or not to turn on open tracking for the message
• track_clicks boolean whether or not to turn on click tracking for the message
• auto_text boolean whether or not to automatically generate a text part for messages that are not given text
• auto_html boolean whether or not to automatically generate an HTML part for messages that are not given HTML
• 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
• url_strip_qs boolean whether or not to strip the query string from URLs when aggregating tracked URL data
• preserve_recipients boolean whether or not to expose all recipients in to "To" header for each email
• view_content_link boolean set to false to remove content logging for sensitive emails
• bcc_address string an optional address to receive an exact copy of each recipient's email
• tracking_domain string a custom domain to use for tracking opens and clicks instead of mandrillapp.com
• signing_domain string a custom domain to use for SPF/DKIM signing instead of mandrill (for "via" or "on behalf of" in email clients)
• return_path_domain string a custom domain to use for the messages's return-path
• merge boolean whether to evaluate merge tags in the message. Will automatically be set to true if either merge_vars or global_merge_vars are provided.
• merge_language string the merge tag language to use when evaluating merge tags, either mailchimp or handlebars
• global_merge_vars array global merge variables to use for all recipients. You can override these per recipient.
• global_merge_vars[] struct a single global merge variable
• name string the global merge variable's name. Merge variable names are case-insensitive and may not start with _
• content mixed the global merge variable's content
• merge_vars array per-recipient merge variables, which override global merge variables with the same name.
• merge_vars[] struct per-recipient merge variables
• rcpt string the email address of the recipient that the merge variables should apply to
• vars array the recipient's merge variables
• vars[] struct a single merge variable
• name string the merge variable's name. Merge variable names are case-insensitive and may not start with _
• content mixed the merge variable's content
• tags array an array of string to tag the message with. Stats are accumulated using tags, though we only store the first 100 we see, so this should not be unique or change frequently. Tags should be 50 characters or less. Any tags starting with an underscore are reserved for internal use and will cause errors.
• tags[] string a single tag - must not start with an underscore
• subaccount string the unique id of a subaccount for this message - must already exist or will fail with an error
• google_analytics_domains array an array of strings indicating for which any matching URLs will automatically have Google Analytics parameters appended to their query string automatically.
• google_analytics_campaign array|string optional string indicating the value to set for the utm_campaign tracking parameter. If this isn't provided the email's from address will be used instead.
• metadata array metadata an associative array of user metadata. Mandrill will store this metadata and make it available for retrieval. In addition, you can select up to 10 metadata fields to index and make searchable using the Mandrill search api.
• recipient_metadata array Per-recipient metadata that will override the global values specified in the metadata parameter.
• recipient_metadata[] struct metadata for a single recipient
• rcpt string the email address of the recipient that the metadata is associated with
• values array an associated array containing the recipient's unique metadata. If a key exists in both the per-recipient metadata and the global metadata, the per-recipient metadata will be used.
• attachments array an array of supported attachments to add to the message
• attachments[] struct a single supported attachment
• type string the MIME type of the attachment
• name string the file name of the attachment
• content string the content of the attachment as a base64-encoded string
• images array an array of embedded images to add to the message
• images[] struct a single embedded image
• type string the MIME type of the image - must start with "image/"
• name string the Content ID of the image - use to reference the image in your HTML content
• content string the content of the image as a base64-encoded string

$async : bool = false

enable a background sending mode that is optimized for bulk sending. In async mode, messages/send will immediately return a status of "queued" for every recipient. To handle rejections when sending in async mode, set up a webhook for the 'reject' event. Defaults to false for messages with no more than 10 recipients; messages with more than 10 recipients are always sent asynchronously, regardless of the value of async.

$ipPool : string = null

the name of the dedicated ip pool that should be used to send the message. If you do not have any dedicated IPs, this parameter has no effect. If you specify a pool that does not exist, your default pool will be used instead.

$sendAt : string = null

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.

sendRaw()

Take a raw MIME document for a message, and send it exactly as if it were sent through Mandrill's SMTP servers.

Parameters

$rawMessage : string

the full MIME document of an email message

$fromEmail : string|null = null

optionally define the sender address - otherwise we'll use the address found in the provided headers

$fromName : string|null = null

optionally define the sender alias

$to : array<string|int, mixed>|null = null

optionally define the recipients to receive the message - otherwise we'll use the To, Cc, and Bcc headers provided in the document

• to[] string the email address of the recipient

$async : bool = false

enable a background sending mode that is optimized for bulk sending. In async mode, messages/sendRaw will immediately return a status of "queued" for every recipient. To handle rejections when sending in async mode, set up a webhook for the 'reject' event. Defaults to false for messages with no more than 10 recipients; messages with more than 10 recipients are always sent asynchronously, regardless of the value of async.

$ipPool : string = null

the name of the dedicated ip pool that should be used to send the message. If you do not have any dedicated IPs, this parameter has no effect. If you specify a pool that does not exist, your default pool will be used instead.

$sendAt : string = null

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.

$returnPathDomain : string = null

a custom domain to use for the messages's return-path

sendTemplate()

Send a new transactional message through Mandrill using a template.

Parameters

$templateName : string

the immutable name or slug of a template that exists in the user's account. For backwards-compatibility, the template name may also be used but the immutable slug is preferred.

$templateContent : array<string|int, mixed>

an array of template content to send. Each item in the array should be a struct with two keys - name: the name of the content block to set the content for, and content: the actual content to put into the block

• template_content[] struct the injection of a single piece of content into a single editable region
• name string the name of the mc:edit editable region to inject into
• content string the content to inject

$message : struct

the other information on the message to send - same as /messages/send, but without the html content

• html string optional full HTML content to be sent if not in template
• text string optional full text content to be sent
• subject string the message subject
• from_email string the sender email address.
• from_name string optional from name to be used
• to array an array of recipient information.
• to[] struct a single recipient's information.
• email string the email address of the recipient
• name string the optional display name to use for the recipient
• type string the header type to use for the recipient, defaults to "to" if not provided
• headers struct optional extra headers to add to the message (most headers are allowed)
• important boolean whether or not this message is important, and should be delivered ahead of non-important messages
• track_opens boolean whether or not to turn on open tracking for the message
• track_clicks boolean whether or not to turn on click tracking for the message
• auto_text boolean whether or not to automatically generate a text part for messages that are not given text
• auto_html boolean whether or not to automatically generate an HTML part for messages that are not given HTML
• 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
• url_strip_qs boolean whether or not to strip the query string from URLs when aggregating tracked URL data
• preserve_recipients boolean whether or not to expose all recipients in to "To" header for each email
• view_content_link boolean set to false to remove content logging for sensitive emails
• bcc_address string an optional address to receive an exact copy of each recipient's email
• tracking_domain string a custom domain to use for tracking opens and clicks instead of mandrillapp.com
• signing_domain string a custom domain to use for SPF/DKIM signing instead of mandrill (for "via" or "on behalf of" in email clients)
• return_path_domain string a custom domain to use for the messages's return-path
• merge boolean whether to evaluate merge tags in the message. Will automatically be set to true if either merge_vars or global_merge_vars are provided.
• merge_language string the merge tag language to use when evaluating merge tags, either mailchimp or handlebars
• global_merge_vars array global merge variables to use for all recipients. You can override these per recipient.
• global_merge_vars[] struct a single global merge variable
• name string the global merge variable's name. Merge variable names are case-insensitive and may not start with _
• content mixed the global merge variable's content
• merge_vars array per-recipient merge variables, which override global merge variables with the same name.
• merge_vars[] struct per-recipient merge variables
• rcpt string the email address of the recipient that the merge variables should apply to
• vars array the recipient's merge variables
• vars[] struct a single merge variable
• name string the merge variable's name. Merge variable names are case-insensitive and may not start with _
• content mixed the merge variable's content
• tags array an array of string to tag the message with. Stats are accumulated using tags, though we only store the first 100 we see, so this should not be unique or change frequently. Tags should be 50 characters or less. Any tags starting with an underscore are reserved for internal use and will cause errors.
• tags[] string a single tag - must not start with an underscore
• subaccount string the unique id of a subaccount for this message - must already exist or will fail with an error
• google_analytics_domains array an array of strings indicating for which any matching URLs will automatically have Google Analytics parameters appended to their query string automatically.
• google_analytics_campaign array|string optional string indicating the value to set for the utm_campaign tracking parameter. If this isn't provided the email's from address will be used instead.
• metadata array metadata an associative array of user metadata. Mandrill will store this metadata and make it available for retrieval. In addition, you can select up to 10 metadata fields to index and make searchable using the Mandrill search api.
• recipient_metadata array Per-recipient metadata that will override the global values specified in the metadata parameter.
• recipient_metadata[] struct metadata for a single recipient
• rcpt string the email address of the recipient that the metadata is associated with
• values array an associated array containing the recipient's unique metadata. If a key exists in both the per-recipient metadata and the global metadata, the per-recipient metadata will be used.
• attachments array an array of supported attachments to add to the message
• attachments[] struct a single supported attachment
• type string the MIME type of the attachment
• name string the file name of the attachment
• content string the content of the attachment as a base64-encoded string
• images array an array of embedded images to add to the message
• images[] struct a single embedded image
• type string the MIME type of the image - must start with "image/"
• name string the Content ID of the image - use to reference the image in your HTML content
• content string the content of the image as a base64-encoded string

$async : bool = false

enable a background sending mode that is optimized for bulk sending. In async mode, messages/send will immediately return a status of "queued" for every recipient. To handle rejections when sending in async mode, set up a webhook for the 'reject' event. Defaults to false for messages with no more than 10 recipients; messages with more than 10 recipients are always sent asynchronously, regardless of the value of async.

$ipPool : string = null

the name of the dedicated ip pool that should be used to send the message. If you do not have any dedicated IPs, this parameter has no effect. If you specify a pool that does not exist, your default pool will be used instead.

$sendAt : string = null

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.