Skip to navigation

API structure

The Marketing API generally follows REST conventions, with some deviations.

  • Resources are typically nouns like subscribers or campaigns.
  • Subresources can be multiply nested under resources.
  • Actions are usually represented by HTTP methods. Actions that do not correspond to HTTP methods are collected under an actions/ subresource.
  • Responses use the generic JSON content type.

We use the OpenAPI Specification (formerly known as Swagger) to describe each endpoint. The API self-description also contains type information to help you error-check your requests.

The root url for the API is https://api.mailchimp.com/3.0/. All API endpoints for your account are available relative to this URL.

For more details on how to query Marketing API endpoints, see Methods and Parameters. For troubleshooting API calls, see the Errors docs.