> ## Documentation Index
> Fetch the complete documentation index at: https://nango.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Mandrill

> Integrate your application with the Mandrill (Mailchimp Transactional) API

## 🚀 Quickstart

Connect to Mandrill with Nango and see data flow in 2 minutes. Mandrill authenticates with a static API key sent in the JSON body of every request, so Nango adds it automatically — you don't need to pass it yourself.

**1. Create the integration**

In Nango ([free signup](https://app.nango.dev)), go to [Integrations](https://app.nango.dev/dev/integrations) -> *Configure New Integration* -> *Mandrill*.

**2. Connect your Mandrill account**

Go to [Connections](https://app.nango.dev/dev/connections) -> *Add Test Connection*. Enter your API key, then save.

**3. Call the Mandrill API**

Let's make your first request to the Mandrill API. Replace the placeholders below with your [Environment API key](https://nango.dev/docs/reference/backend/http-api/api-keys.md), [integration ID](https://app.nango.dev/dev/integrations), and [connection ID](https://app.nango.dev/dev/connections):

> [tab] cURL
>
> ```bash theme={null}
> curl "https://api.nango.dev/proxy/1.3/users/ping" \
>   -X POST \
>   -H "Authorization: Bearer <NANGO-API-KEY>" \
>   -H "Provider-Config-Key: <INTEGRATION-ID>" \
>   -H "Connection-Id: <CONNECTION-ID>" \
>   -H "Content-Type: application/json"
> ```

> [tab] Node
>
> Install Nango's backend SDK with `npm i @nangohq/node`. Then run:
>
> ```typescript theme={null}
> import { Nango } from '@nangohq/node';
>
> const nango = new Nango({ apiKey: '<NANGO-API-KEY>' });
>
> const res = await nango.post({
>     endpoint: '/1.3/users/ping',
>     providerConfigKey: '<INTEGRATION-ID>',
>     connectionId: '<CONNECTION-ID>'
> });
>
> console.log(res.data);
> ```

Or fetch credentials with the [Node SDK](https://nango.dev/docs/reference/backend/backend-sdk/node.md#get-a-connection-with-credentials) or [API](https://nango.dev/docs/reference/backend/http-api/connections/get.md).

✅ You're connected! Check the [Logs](https://app.nango.dev/dev/logs) tab in Nango to inspect requests.

**4. Implement Nango in your app**

Follow our [Auth implementation guide](https://nango.dev/docs/guides/auth/auth-guide.md) to integrate Nango in your app.

To obtain an API key, follow the setup guide linked below.

## 📚 Mandrill integration guides

Nango-maintained guides for common use cases.

* [How to connect your Mandrill account](https://nango.dev/docs/api-integrations/mandrill/connect)\
  Generate an API key in Mandrill and connect it to Nango

Official docs: [Mandrill Transactional API docs](https://mailchimp.com/developer/transactional/api/)

## 🧩 Pre-built syncs & tools for Mandrill

Explore Nango-provided tools in your dashboard. Extend and customize them to fit your needs.

### Others

| Function name | Description | Type |
| - | - | - |
| `add-allowlist-entry` | Add an email address to the rejection allowlist. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `add-inbound-domain` | Add an inbound-routing domain to the account. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `add-inbound-route` | Add a new mailbox route to an inbound domain. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `add-metadata-field` | Add a new custom metadata field definition for the account. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `add-reject` | Add an email address to the rejection denylist. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `add-sender-domain` | Add a sender domain to the account for SPF/DKIM verification. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `add-sms-reject` | Add a phone number to the SMS rejection denylist. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `add-tracking-domain` | Add a click/open-tracking domain to the account. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `cancel-scheduled-message` | Cancel a scheduled email before it sends. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `check-inbound-domain` | Check the MX settings for an inbound-routing domain. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `check-ip-custom-dns` | Test whether a custom reverse DNS record is correctly configured for a dedicated IP. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `check-sender-domain` | Check the SPF and DKIM settings for a sender domain. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `check-tracking-domain` | Check the CNAME settings for a tracking domain. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-ip-pool` | Create a new dedicated IP pool. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-subaccount` | Add a new subaccount. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-template` | Add a new Mandrill template. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-webhook` | Add a new webhook for account events | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-allowlist-entry` | Remove an email address from the rejection allowlist. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-dedicated-ip` | Delete a dedicated IP. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-inbound-domain` | Delete an inbound-routing domain from the account. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-inbound-route` | Delete an existing inbound mailbox route. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-ip-pool` | Delete a dedicated IP pool. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-metadata-field` | Delete an existing custom metadata field definition. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-reject` | Remove an email address from the rejection denylist. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-sender-domain` | Delete an unverified sender domain from the account. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-sms-reject` | Remove a phone number from the SMS rejection denylist. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-subaccount` | Delete an existing subaccount. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-tag` | Permanently delete a tag and its stats. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-template` | Delete a template. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-tracking-domain` | Delete an unverified tracking domain from the account. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-webhook` | Delete an existing webhook. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-account-info` | Return information about the API-connected Mandrill account/user. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-all-tags-time-series` | Get recent hourly stats aggregated across all tags | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-export-info` | Get the status and (if finished) download URL of an export job. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-ip-pool-info` | Get information about a single dedicated IP pool. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-message-content` | Get the full content (headers, html, text) of a single recently sent message. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-message-info` | Get delivery/tracking information for a single recently sent message. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-sender-info` | Get detailed sending information about a single sender address. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-sender-time-series` | Get recent hourly stats for a single sender address. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-subaccount-info` | Get detailed information about a single subaccount. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-tag-info` | Get detailed information about a single tag. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-tag-time-series` | Get recent hourly stats for a single tag. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-template-info` | Get information for a single existing template. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-template-time-series` | Get recent hourly stats for a single template. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-webhook-info` | Get data about a single existing webhook. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-account-senders` | List the sender email addresses (verified and unverified) that have been used on this account. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-exports` | List the account's export jobs. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-scheduled-messages` | List messages that are scheduled to be sent in the future. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `parse-mime-message` | Parse a raw MIME document into its constituent pieces (headers, text, html, attachments) without sending it. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `pause-subaccount` | Pause a subaccount's sending. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `ping-api-v2` | Validate an API key using the JSON parser version of the ping. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `ping-api` | Validate an API key and respond to a ping (legacy parser). | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `publish-template` | Publish the draft content of a template so it becomes the live version. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `render-template` | Inject content and merge variables into a template and return the rendered HTML, without sending it. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `reschedule-message` | Change the send time of a scheduled email. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `resume-subaccount` | Resume a paused subaccount's sending. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `search-messages-time-series` | Search recently sent messages and return hourly send/open/click/bounce stats instead of individual messages. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `search-messages` | Search recently sent messages by date range, query, tags, senders, or API key. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `send-message-template` | Send a transactional email rendered from a stored Mandrill template. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `send-message` | Send a new transactional email message. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `send-raw-inbound-message` | Take a raw MIME document and pass it through Mandrill's inbound webhook pipeline as if it had arrived by email. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `send-raw-message` | Send a raw MIME document as a transactional message. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `start-activity-export` | Begin an asynchronous export of the account's activity history. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `start-allowlist-export` | Begin an asynchronous export of the account's rejection allowlist. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `start-rejects-export` | Begin an asynchronous export of the account's rejection denylist. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-inbound-route` | Update the pattern or destination webhook of an existing inbound route. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-metadata-field` | Update an existing custom metadata field definition. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-subaccount` | Update an existing subaccount's name, notes, or custom quota. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-template` | Update the code/content of an existing template. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-webhook` | Update an existing webhook's url, description, or subscribed events. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `verify-sender-domain` | Send a verification email to confirm ownership of a sender domain. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `allowlist` | Sync all entries on the rejection allowlist. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `dedicated-ips` | Sync all dedicated IPs on this account. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `inbound-domains` | Sync all inbound-routing domains configured on this account. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `inbound-routes` | Sync all inbound mailbox routes across all known inbound domains | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `ip-pools` | Sync all dedicated IP pools on this account. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `mc-templates` | Sync all Mailchimp (not Mandrill) templates available to this account. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `messages` | Sync recently sent transactional messages (activity log). | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `metadata-fields` | Sync all custom metadata field definitions configured on this account. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `rejects-sms` | Sync all entries on the SMS rejection denylist. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `rejects` | Sync all entries on the email rejection denylist. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `sender-domains` | Sync sender domains added to the account for SPF/DKIM verification. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `senders` | Sync sender addresses that have been used to send from this account. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `subaccounts` | Sync all subaccounts on this account. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `tags` | Sync all user-defined tags and their aggregate stats | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `templates` | Sync all Mandrill templates. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `tracking-domains` | Sync all click/open-tracking domains configured on this account. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `webhooks` | Sync all webhooks configured on this account. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |

***


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.