---
name: mailchimp-transactional-api
description: "Mailchimp Transactional API skill. Use when working with Mailchimp Transactional for allowlists, exports, ips. Covers 99 endpoints."
version: 1.0.0
generator: lapsh
---

# Mailchimp Transactional API
API version: 1.4.0

## Auth
Detected auth parameter: `key` (found in parameter)

## Base URL
https://mandrillapp.com/api/1.4

## Setup
1. Set the `key` parameter for authentication
2. Verify API access with a test request
3. POST /allowlists/add -- create first add

## Endpoints
99 endpoints across 15 groups. See references/api-spec.lap for full details.

### Allowlists
| Method | Path | Description |
|--------|------|-------------|
| POST | /allowlists/add | Add email to allowlist |
| POST | /allowlists/list | List allowlist entries |
| POST | /allowlists/delete | Remove email from allowlist |

### Exports
| Method | Path | Description |
|--------|------|-------------|
| POST | /exports/info | Get export job information |
| POST | /exports/list | List export jobs |
| POST | /exports/rejects | Export rejection blacklist |
| POST | /exports/whitelist | Export rejection allowlist (legacy) |
| POST | /exports/allowlist | Export rejection allowlist |
| POST | /exports/activity | Export activity history |

### Ips
| Method | Path | Description |
|--------|------|-------------|
| POST | /ips/list | List dedicated IPs |
| POST | /ips/info | Get dedicated IP information |
| POST | /ips/provision | Request dedicated IP provisioning |
| POST | /ips/start-warmup | Start IP warmup process |
| POST | /ips/cancel-warmup | Cancel IP warmup process |
| POST | /ips/set-pool | Move IP to different pool |
| POST | /ips/delete | Delete dedicated IP |
| POST | /ips/list-pools | List dedicated IP pools |
| POST | /ips/pool-info | Get pool information |
| POST | /ips/create-pool | Create dedicated IP pool |
| POST | /ips/delete-pool | Delete dedicated IP pool |
| POST | /ips/check-custom-dns | Test custom DNS configuration |
| POST | /ips/set-custom-dns | Configure custom DNS for IP |

### Inbound
| Method | Path | Description |
|--------|------|-------------|
| POST | /inbound/domains | List inbound domains |
| POST | /inbound/add-domain | Add inbound domain |
| POST | /inbound/check-domain | Check domain settings |
| POST | /inbound/delete-domain | Delete inbound domain |
| POST | /inbound/routes | List mailbox routes |
| POST | /inbound/add-route | Add mailbox route |
| POST | /inbound/update-route | Update mailbox route |
| POST | /inbound/delete-route | Delete mailbox route |
| POST | /inbound/send-raw | Send mime document |

### Mctemplates
| Method | Path | Description |
|--------|------|-------------|
| POST | /mctemplates/info | Get Mailchimp Transactional template information |
| POST | /mctemplates/list | List Mailchimp Transactional templates |
| POST | /mctemplates/render | Render a Mailchimp Transactional template |
| POST | /mctemplates/time-series | Get Mailchimp Transactional template time series |

### Messages
| Method | Path | Description |
|--------|------|-------------|
| POST | /messages/send | Send a new transactional message through the Transactional API. |
| POST | /messages/send-template | Send a new transactional message using a template |
| POST | /messages/send-mc-template | Send using Mailchimp template |
| POST | /messages/search | Search recently sent messages |
| POST | /messages/search-time-series | Get time series data for message search |
| POST | /messages/info | Get information about a single sent message |
| POST | /messages/content | Get the full content of a sent message |
| POST | /messages/parse | Parse a MIME message |
| POST | /messages/send-raw | Send a raw MIME message through Mandrill |
| POST | /messages/list-scheduled | Get scheduled emails |
| POST | /messages/cancel-scheduled | Cancel a scheduled email |
| POST | /messages/reschedule | Reschedule a scheduled email |
| POST | /messages/send-sms | Send SMS message |

### Metadata
| Method | Path | Description |
|--------|------|-------------|
| POST | /metadata/list | List custom metadata fields |
| POST | /metadata/add | Add custom metadata field |
| POST | /metadata/update | Update custom metadata field |
| POST | /metadata/delete | Delete custom metadata field |

### Rejects
| Method | Path | Description |
|--------|------|-------------|
| POST | /rejects/add | Add email to rejection blacklist |
| POST | /rejects/add-sms | Add phone number to SMS rejection denylist |
| POST | /rejects/list | List rejection blacklist entries |
| POST | /rejects/list-sms | List SMS rejection denylist entries |
| POST | /rejects/delete | Delete email from rejection blacklist |
| POST | /rejects/delete-sms | Delete phone number from SMS rejection denylist |

### Senders
| Method | Path | Description |
|--------|------|-------------|
| POST | /senders/list | List senders used by this account |
| POST | /senders/domains | List sender domains |
| POST | /senders/add-domain | Add a sender domain |
| POST | /senders/check-domain | Check domain SPF and DKIM |
| POST | /senders/verify-domain | Verify a sender domain by email |
| POST | /senders/info | Get detailed information for a sender |
| POST | /senders/time-series | Get hourly stats for a sender |
| POST | /senders/delete-domain | Delete a sender domain |

### Subaccounts
| Method | Path | Description |
|--------|------|-------------|
| POST | /subaccounts/list | List subaccounts |
| POST | /subaccounts/add | Add a new subaccount |
| POST | /subaccounts/info | Get subaccount information |
| POST | /subaccounts/update | Update an existing subaccount |
| POST | /subaccounts/delete | Delete a subaccount |
| POST | /subaccounts/pause | Pause a subaccount |
| POST | /subaccounts/resume | Resume a paused subaccount |

### Tags
| Method | Path | Description |
|--------|------|-------------|
| POST | /tags/list | List all user-defined tags |
| POST | /tags/delete | Delete a tag permanently |
| POST | /tags/info | Get detailed information about a tag |
| POST | /tags/time-series | Get time series data for a specific tag |
| POST | /tags/all-time-series | Get time series data for all tags |

### Templates
| Method | Path | Description |
|--------|------|-------------|
| POST | /templates/add | Add a new template |
| POST | /templates/info | Get template information |
| POST | /templates/update | Update an existing template |
| POST | /templates/publish | Publish a template |
| POST | /templates/delete | Delete a template |
| POST | /templates/list | List all templates |
| POST | /templates/time-series | Get template time series data |
| POST | /templates/render | Render a template |

### Urls
| Method | Path | Description |
|--------|------|-------------|
| POST | /urls/tracking-domains | Get tracking domains |
| POST | /urls/add-tracking-domain | Add tracking domain |
| POST | /urls/check-tracking-domain | Check tracking domain |
| POST | /urls/delete-tracking-domain | Delete a tracking domain |

### Users
| Method | Path | Description |
|--------|------|-------------|
| POST | /users/info | Return the information about the API-connected user |
| POST | /users/ping | Validate an API key and respond to a ping |
| POST | /users/ping2 | Validate an API key and respond to a ping (strict JSON parser version) |
| POST | /users/senders | Return the senders that have tried to use this account |

### Webhooks
| Method | Path | Description |
|--------|------|-------------|
| POST | /webhooks/list | Get the list of all webhooks |
| POST | /webhooks/add | Add a new webhook |
| POST | /webhooks/info | Get webhook information |
| POST | /webhooks/update | Update an existing webhook |
| POST | /webhooks/delete | Delete an existing webhook |

## Common Questions
Match user requests to endpoints in references/api-spec.lap. Key patterns:
- "Create a add?" -> POST /allowlists/add
- "Create a list?" -> POST /allowlists/list
- "Create a delete?" -> POST /allowlists/delete
- "Create a info?" -> POST /exports/info
- "Create a reject?" -> POST /exports/rejects
- "Create a whitelist?" -> POST /exports/whitelist
- "Create a allowlist?" -> POST /exports/allowlist
- "Create a activity?" -> POST /exports/activity
- "Create a provision?" -> POST /ips/provision
- "Create a start-warmup?" -> POST /ips/start-warmup
- "Create a cancel-warmup?" -> POST /ips/cancel-warmup
- "Create a set-pool?" -> POST /ips/set-pool
- "Create a list-pool?" -> POST /ips/list-pools
- "Create a pool-info?" -> POST /ips/pool-info
- "Create a create-pool?" -> POST /ips/create-pool
- "Create a delete-pool?" -> POST /ips/delete-pool
- "Create a check-custom-dn?" -> POST /ips/check-custom-dns
- "Create a set-custom-dn?" -> POST /ips/set-custom-dns
- "Create a domain?" -> POST /inbound/domains
- "Create a add-domain?" -> POST /inbound/add-domain
- "Create a check-domain?" -> POST /inbound/check-domain
- "Create a delete-domain?" -> POST /inbound/delete-domain
- "Create a route?" -> POST /inbound/routes
- "Create a add-route?" -> POST /inbound/add-route
- "Create a update-route?" -> POST /inbound/update-route
- "Create a delete-route?" -> POST /inbound/delete-route
- "Create a send-raw?" -> POST /inbound/send-raw
- "Create a render?" -> POST /mctemplates/render
- "Create a time-sery?" -> POST /mctemplates/time-series
- "Create a send?" -> POST /messages/send
- "Create a send-template?" -> POST /messages/send-template
- "Create a send-mc-template?" -> POST /messages/send-mc-template
- "Create a search?" -> POST /messages/search
- "Create a search-time-sery?" -> POST /messages/search-time-series
- "Create a content?" -> POST /messages/content
- "Create a parse?" -> POST /messages/parse
- "Create a list-scheduled?" -> POST /messages/list-scheduled
- "Create a cancel-scheduled?" -> POST /messages/cancel-scheduled
- "Create a reschedule?" -> POST /messages/reschedule
- "Create a send-sm?" -> POST /messages/send-sms
- "Create a update?" -> POST /metadata/update
- "Create a add-sm?" -> POST /rejects/add-sms
- "Create a list-sm?" -> POST /rejects/list-sms
- "Create a delete-sm?" -> POST /rejects/delete-sms
- "Create a verify-domain?" -> POST /senders/verify-domain
- "Create a pause?" -> POST /subaccounts/pause
- "Create a resume?" -> POST /subaccounts/resume
- "Create a all-time-sery?" -> POST /tags/all-time-series
- "Create a publish?" -> POST /templates/publish
- "Create a tracking-domain?" -> POST /urls/tracking-domains
- "Create a add-tracking-domain?" -> POST /urls/add-tracking-domain
- "Create a check-tracking-domain?" -> POST /urls/check-tracking-domain
- "Create a delete-tracking-domain?" -> POST /urls/delete-tracking-domain
- "Create a ping?" -> POST /users/ping
- "Create a ping2?" -> POST /users/ping2
- "Create a sender?" -> POST /users/senders
- "How to authenticate?" -> See Auth section above

## Response Tips
- Check response schemas in references/api-spec.lap for field details
- Create/update endpoints return the modified resource on success
- Error responses include status codes and descriptions in the spec

## References
- Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas

> Generated from the official API spec by [LAP](https://lap.sh)
