Mailchimp Developer LogoMailchimp Developer Wordmark
December 19, 2023Action Required

New sending domain authentication requirements

Transactional

What

Beginning in February 2024, we'll be enforcing new sending domain authentication requirements that you'll need to take action on.

Why

Google and Yahoo recently announced new sending requirements that will go into effect in February 2024. In order to comply, Mailchimp Transactional users will have to update their DKIM records and enact a DMARC policy on any sending domain that might be used. Failure to update your domain’s authentication will result in emails being rejected (not sent) once the change goes live.

Here's how you can get started:

DKIM

Create two CNAME records: one with the name mte1._domainkey.yourdomain.com with the value dkim1.mandrillapp.com, and another with the name mte2._domainkey.yourdomain.com and the value dkim2.mandrillapp.com 

DMARC

Create and save a TXT record in your DNS with a name of _dmarc.yourdomain.com and a value of v=DMARC1; p=none

Replace yourdomain.com with the domain you're setting up. Some domain hosts automatically add yourdomain.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

    Transactional

    What

    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.

  • July 3, 2023Action Required

    Changing API server response for client errors

    Transactional

    What

    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 servers respond if you provide invalid or missing data when performing a request to our API. Once this change goes live, we’ll respond with an HTTP 400 Bad Request, indicating you will have to make changes to your payload in the subsequent requests. 

    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 or missing payload. We’re updating this to bring our response in line with proper semantics and allow more efficient status monitoring.

  • June 1, 2023Action Required

    Export API 1.0 and API 2.0 no longer supported

    Marketing

    What

    We retired API Export 1.0 and API 2.0 on June 1, 2023.  We won’t support calls to these endpoints after the retirement date and will return an HTTP 410 status message. If your application or integration still makes use of these endpoints, you’ll need to update it to our Marketing API 3.0.

    Why

    We deprecated API Export 1.0 and API 2.0 on December 31, 2016 and have encouraged our developer community to upgrade to API 3.0 in the intervening time. Although we've continued to support the deprecated endpoints, they've seen increasing performance issues and it’s no longer viable to maintain them.

  • April 14, 2023Action Required

    Changing messages/info server response

    Transactional

    What

    We’ve been updating our API responses recently to provide a more semantic response for the requests you make. With this release, our servers will respond an HTTP 404 Not Found if you provide an invalid message ID when requesting message information.

    If you’re specifically targeting HTTP response codes other than 200, you may need to update your code.

    Why

    Previously, we responded with an HTTP 500 Server Error when you provided an invalid message ID. We’re updating this to bring our response in line with proper semantics and allow more efficient status monitoring.

  • April 20, 2023

    Added client secret rotation functionality

    Marketing

    What

    We've added functionality to allow you to rotate any client secrets you may have generated for your applications.

    Why

    We added this functionality to make it easier to keep your applications secure. For more details, see Access Data on Behalf of Other Users with OAuth 2.

  • April 19, 2023Action Required

    Subject and TO header no longer require encoding

    Transactional

    What

    We’ve recently updated how we encode email headers, so that Subject Lines and the recipient headers (like TO, CC, etc) no longer require users to encode non-ASCII characters.

    Why

    We made this change to make it easier for users to send emoji or non-standard text in the Subject, To Address, and To Name. Now, you can pass in those characters directly instead of having to encode them in your email.

  • April 10, 2023Action Required

    Message search rate limit now enforced

    Transactional

    What

    We’re now enforcing the message search rate limit described in the Search messages by date endpoint. If you exceed the limit of 20 searches per minute, we’ll now return a 429 Too Many Requests response code. You can retry your request 60 seconds after you sent the first of the original 20 requests.

    You may want to monitor your responses for an increase in 429 codes so that you can change your request system to submit no more than 20 searches per minute if necessary.

    Why

    We’re enforcing the search request limit to increase system efficiency and minimize overall response time.