Mandrill
Mock the Mandrill transactional email API to test send flows, template handling, and webhook integrations without a live Mailchimp account.
[01]
About
Mock 90 endpoints of the Mandrill API: send messages, manage templates, handle subaccounts, query rejects/whitelist, configure webhooks, list senders and tags, and inspect metadata. Useful for testing transactional-email pipelines, template rendering, or webhook handling without sending real mail.
Endpoints
90 across 0 resource groups
Methods
POST 90 none deprecated
OpenAPI
3.0.1 spec version 1.0
Source spec
99 KB · YAML
view raw →
[02]
Endpoints
| POST |
/exports/activity.json
|
Begins an export of your activity history. The activity will be exported to a zip archive containing a single file named activity.csv in the same format as you would be able to export from your account's activity view. It includes the following fields: Date, Email Address, Sender, Subject, Status, Tags, Opens, Clicks, Bounce Detail. If you have configured any custom metadata fields, they will be included in the exported data. Mocked via Mockzilla.
|
| POST |
/exports/info.json
|
Returns information about an export job. If the export job's state is 'complete', the returned data will include a URL you can use to fetch the results. Every export job produces a zip archive, but the format of the archive is distinct for each job type. The api calls that initiate exports include more details about the output format for that job type.
|
| POST |
/exports/list.json
|
Returns a list of your exports.
|
| POST |
/exports/rejects.json
|
Begins an export of your rejection blacklist. The blacklist will be exported to a zip archive containing a single file named rejects.csv that includes the following fields: email, reason, detail, created_at, expires_at, last_event_at, expires_at.
|
| POST |
/exports/whitelist.json
|
Begins an export of your rejection whitelist. The whitelist will be exported to a zip archive containing a single file named whitelist.csv that includes the following fields: email, detail, created_at.
|
| POST |
/inbound/add-domain.json
|
Add an inbound domain to your account. Available as a Mockzilla mock endpoint.
|
| POST |
/inbound/add-route.json
|
Add a new mailbox route to an inbound domain
|
| POST |
/inbound/check-domain.json
|
Check the MX settings for an inbound domain. The domain must have already been added with the add-domain call
|
| POST |
/inbound/delete-domain.json
|
Delete an inbound domain from the account. All mail will stop routing for this domain immediately.
|
| POST |
/inbound/delete-route.json
|
Delete an existing inbound mailbox route
|
| POST |
/inbound/domains.json
|
List the domains that have been configured for inbound delivery. Mockzilla mock: no signup, no API key.
|
| POST |
/inbound/routes.json
|
List the mailbox routes defined for an inbound domain
|
| POST |
/inbound/send-raw.json
|
Take a raw MIME document destined for a domain with inbound domains set up, and send it to the inbound hook exactly as if it had been sent over SMTP
|
| POST |
/inbound/update-route.json
|
Update the pattern or webhook of an existing inbound mailbox route. If null is provided for any fields, the values will remain unchanged.
|
| POST |
/ips/cancel-warmup.json
|
Cancels the warmup process for a dedicated IP.
|
| POST |
/ips/check-custom-dns.json
|
Tests whether a domain name is valid for use as the custom reverse DNS for a dedicated IP. Served by the Mockzilla mock runtime.
|
| POST |
/ips/create-pool.json
|
Creates a pool and returns it. If a pool already exists with this name, no action will be performed.
|
| POST |
/ips/delete-pool.json
|
Deletes a pool. A pool must be empty before you can delete it, and you cannot delete your default pool.
|
| POST |
/ips/delete.json
|
Deletes a dedicated IP. This is permanent and cannot be undone.
|
| POST |
/ips/info.json
|
Retrieves information about a single dedicated ip.
|
| POST |
/ips/list-pools.json
|
Lists your dedicated IP pools. Mocked via Mockzilla.
|
| POST |
/ips/list.json
|
Lists your dedicated IPs.
|
| POST |
/ips/pool-info.json
|
Describes a single dedicated IP pool.
|
| POST |
/ips/provision.json
|
Requests an additional dedicated IP for your account. Accounts may have one outstanding request at any time, and provisioning requests are processed within 24 hours.
|
| POST |
/ips/set-custom-dns.json
|
Configures the custom DNS name for a dedicated IP.
|
| POST |
/ips/set-pool.json
|
Moves a dedicated IP to a different pool. Available as a Mockzilla mock endpoint.
|
| POST |
/ips/start-warmup.json
|
Begins the warmup process for a dedicated IP. During the warmup process, Mandrill will gradually increase the percentage of your mail that is sent over the warming-up IP, over a period of roughly 30 days. The rest of your mail will be sent over shared IPs or other dedicated IPs in the same pool.
|
| POST |
/messages/cancel-scheduled.json
|
Cancels a scheduled email.
|
| POST |
/messages/content.json
|
Get the full content of a recently sent message
|
| POST |
/messages/info.json
|
Get the information for a single recently sent message
|
| POST |
/messages/list-scheduled.json
|
Queries your scheduled emails by sender or recipient, or both. Mockzilla mock: no signup, no API key.
|
| POST |
/messages/parse.json
|
Parse the full MIME document for an email message, returning the content of the message broken into its constituent pieces
|
| POST |
/messages/reschedule.json
|
Reschedules a scheduled email.
|
| POST |
/messages/search-time-series.json
|
Search the content of recently sent messages and return the aggregated hourly stats for matching messages
|
| POST |
/messages/search.json
|
Search the content of recently sent messages and optionally narrow by date range, tags and senders. This method may be called up to 20 times per minute. If you need the data more often, you can use /messages/info.json to get the information for a single message, or webhooks to push activity to your own application for querying.
|
| POST |
/messages/send-raw.json
|
Take a raw MIME document for a message, and send it exactly as if it were sent through Mandrill's SMTP servers. Served by the Mockzilla mock runtime.
|
| POST |
/messages/send-template.json
|
Send a new transactional message through Mandrill using a template
|
| POST |
/messages/send.json
|
Send a new transactional message through Mandrill
|
| POST |
/metadata/add.json
|
Add a new custom metadata field to be indexed for the account.
|
| POST |
/metadata/delete.json
|
Delete an existing custom metadata field. Deletion isn't instataneous, and /metadata/list will continue to return the field until the asynchronous deletion process is complete.
|
| POST |
/metadata/list.json
|
Get the list of custom metadata fields indexed for the account. Mocked via Mockzilla.
|
| POST |
/metadata/update.json
|
Update an existing custom metadata field.
|
| POST |
/rejects/add.json
|
Adds an email to your email rejection blacklist. Addresses that you add manually will never expire and there is no reputation penalty for removing them from your blacklist. Attempting to blacklist an address that has been whitelisted will have no effect.
|
| POST |
/rejects/delete.json
|
Deletes an email rejection. There is no limit to how many rejections you can remove from your blacklist, but keep in mind that each deletion has an affect on your reputation.
|
| POST |
/rejects/list.json
|
Retrieves your email rejection blacklist. You can provide an email address to limit the results. Returns up to 1000 results. By default, entries that have expired are excluded from the results; set include_expired to true to include them.
|
| POST |
/senders/add-domain.json
|
Adds a sender domain to your account. Sender domains are added automatically as you send, but you can use this call to add them ahead of time. Available as a Mockzilla mock endpoint.
|
| POST |
/senders/check-domain.json
|
Checks the SPF and DKIM settings for a domain. If you haven't already added this domain to your account, it will be added automatically.
|
| POST |
/senders/domains.json
|
Returns the sender domains that have been added to this account.
|
| POST |
/senders/info.json
|
Return more detailed information about a single sender, including aggregates of recent stats
|
| POST |
/senders/list.json
|
Return the senders that have tried to use this account.
|
| POST |
/senders/time-series.json
|
Return the recent history (hourly stats for the last 30 days) for a sender. Mockzilla mock: no signup, no API key.
|
| POST |
/senders/verify-domain.json
|
Sends a verification email in order to verify ownership of a domain. Domain verification is an optional step to confirm ownership of a domain. Once a domain has been verified in a Mandrill account, other accounts may not have their messages signed by that domain unless they also verify the domain. This prevents other Mandrill accounts from sending mail signed by your domain.
|
| POST |
/subaccounts/add.json
|
Add a new subaccount
|
| POST |
/subaccounts/delete.json
|
Delete an existing subaccount. Any email related to the subaccount will be saved, but stats will be removed and any future sending calls to this subaccount will fail.
|
| POST |
/subaccounts/info.json
|
Given the ID of an existing subaccount, return the data about it
|
| POST |
/subaccounts/list.json
|
Get the list of subaccounts defined for the account, optionally filtered by a prefix. Served by the Mockzilla mock runtime.
|
| POST |
/subaccounts/pause.json
|
Pause a subaccount's sending. Any future emails delivered to this subaccount will be queued for a maximum of 3 days until the subaccount is resumed.
|
| POST |
/subaccounts/resume.json
|
Resume a paused subaccount's sending
|
| POST |
/subaccounts/update.json
|
Update an existing subaccount
|
| POST |
/tags/all-time-series.json
|
Return the recent history (hourly stats for the last 30 days) for all tags
|
| POST |
/tags/delete.json
|
Deletes a tag permanently. Deleting a tag removes the tag from any messages that have been sent, and also deletes the tag's stats. There is no way to undo this operation, so use it carefully. Mocked via Mockzilla.
|
| POST |
/tags/info.json
|
Return more detailed information about a single tag, including aggregates of recent stats
|
| POST |
/tags/list.json
|
Return all of the user-defined tag information
|
| POST |
/tags/time-series.json
|
Return the recent history (hourly stats for the last 30 days) for a tag
|
| POST |
/templates/add.json
|
Add a new template
|
| POST |
/templates/delete.json
|
Delete a template. Available as a Mockzilla mock endpoint.
|
| POST |
/templates/info.json
|
Get the information for an existing template
|
| POST |
/templates/list.json
|
Return a list of all the templates available to this user
|
| POST |
/templates/publish.json
|
Publish the content for the template. Any new messages sent using this template will start using the content that was previously in draft.
|
| POST |
/templates/render.json
|
Inject content and optionally merge fields into a template, returning the HTML that results
|
| POST |
/templates/time-series.json
|
Return the recent history (hourly stats for the last 30 days) for a template. Mockzilla mock: no signup, no API key.
|
| POST |
/templates/update.json
|
Update the code for an existing template. If null is provided for any fields, the values will remain unchanged.
|
| POST |
/urls/add-tracking-domain.json
|
Add a tracking domain to your account
|
| POST |
/urls/check-tracking-domain.json
|
Checks the CNAME settings for a tracking domain. The domain must have been added already with the add-tracking-domain call
|
| POST |
/urls/list.json
|
Get the 100 most clicked URLs
|
| POST |
/urls/search.json
|
Return the 100 most clicked URLs that match the search query given. Served by the Mockzilla mock runtime.
|
| POST |
/urls/time-series.json
|
Return the recent history (hourly stats for the last 30 days) for a url
|
| POST |
/urls/tracking-domains.json
|
Get the list of tracking domains set up for this account
|
| POST |
/users/info.json
|
Return the information about the API-connected user
|
| POST |
/users/ping.json
|
Validate an API key and respond to a ping
|
| POST |
/users/ping2.json
|
Validate an API key and respond to a ping (anal JSON parser version). Mocked via Mockzilla.
|
| POST |
/users/senders.json
|
Return the senders that have tried to use this account, both verified and unverified
|
| POST |
/webhooks/add.json
|
Add a new webhook
|
| POST |
/webhooks/delete.json
|
Delete an existing webhook
|
| POST |
/webhooks/info.json
|
Given the ID of an existing webhook, return the data about it
|
| POST |
/webhooks/list.json
|
Get the list of all webhooks defined on the account. Available as a Mockzilla mock endpoint.
|
| POST |
/webhooks/update.json
|
Update an existing webhook
|
| POST |
/whitelists/add.json
|
Adds an email to your email rejection whitelist. If the address is currently on your blacklist, that blacklist entry will be removed automatically.
|
| POST |
/whitelists/delete.json
|
Removes an email address from the whitelist.
|
| POST |
/whitelists/list.json
|
Retrieves your email rejection whitelist. You can provide an email address or search prefix to limit the results. Returns up to 1000 results.
|