Mailchimp Transactional status added to server status page
What
We've added live status tracking for Mailchimp Transactional API's servers to the Mailchimp Server Status page. The page shows the current status and a history of recent service outages and their resolutions to help you troubleshoot your API calls and responses.
Why
This lets you check the status of the Mailchimp Transactional servers quickly and easily, on the same page as our other servers.
- August 7, 2025Action Required
New Audiences endpoints (BETA)
MarketingWhat
We’ve launched new Audiences endpoints (BETA) as an alternative to our List Members endpoints. These allow for contacts to be added with just an SMS number. These endpoints are still in BETA but includes the following capabilities: create, update, read, forget and archive a contact without reliance on an email value.
The Audiences Endpoints (BETA) are available for evaluation or testing purposes only, may contain bugs or errors, and may not be as reliable as other Mailchimp features. Intuit may modify or discontinue this feature at any time without notice. By accessing the endpoints you agree to the Audiences Endpoints (BETA) Terms of Use. Consent must be accurately mapped to the supported marketing consent values. Unsupported values, including opt-outs, must be updated manually. See the Audiences (BETA) developer document for terms and additional details.
Why
Previously, the creation of a contact via our API relied on the presence of an email. We’re launching this new endpoint to allow for SMS customers to bring over their full contact list, including contacts with no email.
- December 6, 2024Action Required
Overwriting campaign_id and outreach_id
MarketingWhat
We've started writing over the
campaign_id
oroutreach_id
values on Orders to align with our new attribution model and user-configured settings. If your integration is sendingcampaign_id
oroutreach_id
with Add Order or Update Order API calls, we recommend deprecating that logic.Why
We’re rolling out Mailchimp's native attribution model across all e-commerce integrations. This new model gives you more complete insights into how marketing campaigns contribute to customer purchases. It also improves marketing performance reporting for all Mailchimp customers using e-commerce integrations. Additionally, this reduces the need for complex custom logic for attributing orders to specific marketing messages.
- June 17, 2024
Webhook retry interval increased
TransactionalWhat
We’ve increased the number of times that a webhook will retry when we don’t initially receive a 200 response. We will now retry up to 20 times, at intervals of 15-25 minutes per retry. After 20 unsuccessful attempts, the webhook will be disabled.
Why
Increasing this interval gives users more time to troubleshoot their webhook endpoint, and retains the webhook payload for longer.
- February 12, 2024Action Required
Updated Mailchimp Transactional client libraries
TransactionalWhat
We've published an updated package for the PHP client library that is compatible with PHP 8.2.
We've also published an updated package for the Node.js client library that uses the latest version of Axios to address a security vulnerability.
Why
Older versions of the PHP client library caused errors when used with PHP 8.2.
A vulnerability was found in versions 0.8.1 through 1.5.1 of Axios, which unintentionally exposed the
XSRF-TOKEN
that was stored in cookies by including it in theX-XSRF-TOKEN
HTTP header for all requests to any host. This allowed malicious actors possible access to sensitive data. To address this issue, we have updated the Node.js client library to use the latest version of Axios. - June 5, 2023Action Required
Retiring legacy versions of Transport Layer Security (TLS) protocol
TransactionalWhat
As of July 18, 2023, Mailchimp Transactional no longer supports Transport Layer Security protocol (TLS) v1.0 and v1.1. We already support TLS v.1.2 and above. If you're not using TLS v1.2 or above, this may require coding changes.
Why
TLS v1.0 and v.1.1 have been sunsetted so we are making the corresponding changes.
- December 19, 2023Action Required
New sending domain authentication requirements
TransactionalWhat
Beginning on March 15, 2024, we'll be enforcing new sending domain authentication requirements that you'll need to act on.
Why
Google and Yahoo recently announced new sending requirements that will go into effect soon. To comply with these changes, Mailchimp Transactional users will have to update their DKIM records and enact a DMARC policy on any sending domain that might be used.
If you fail to update your domain’s authentication, we’ll use a
mandrillapp.com
subdomain as the sending domain for your email address, but replies from recipients will still go to your email address. This change will apply to any email sent through Mandrill that is currently authenticated but doesn't meet our new authentication requirements after March 15.Here's how you can get started:
DKIM
Create two CNAME records: one with the name
mte1._domainkey.
yourdomain.com
with the valuedkim1.mandrillapp.com
, and another with the namemte2._domainkey.
yourdomain.com
and the valuedkim2.mandrillapp.com
DMARC
Create and save a TXT record in your DNS with a name of
_dmarc.
yourdomain.com
and a value ofv=DMARC1; p=none
Replace
yourdomain.com
with the domain you're setting up. Some domain hosts automatically addyourdomain.com
after the initial value—contact your domain provider for any specifics.We’ve updated the Mailchimp Transactional app and documentation to include these instructions, and to give you the ability to test these records on your Sending Domains page.
- June 17, 2023Action Required
Response code updated for invalid template name
TransactionalWhat
We’ve been updating our API responses recently to provide a more semantic response for the requests you make. With this release, we’re changing the way our API responds if you provide an invalid template name when requesting template information or if you try to send a message using a template that doesn’t exist. Once this change goes live, we’ll respond with an HTTP 404 Not Found.
If you’re specifically targeting HTTP response codes other than 200, you may need to update your code. We’re releasing this change incrementally over the next few weeks.
Why
Previously, we responded with an HTTP 500 Server Error when you provided an invalid template name or slug. We’re updating this to bring our response in line with proper semantics and allow more efficient status monitoring.