Mailchimp

Mailchimp Subaccounts API

Manage subaccounts for organizing sending and reporting within a single Mandrill account.

GitHub OpenAPI

Operations 7

POST /subaccounts/list List subaccounts #
POST /subaccounts/add Add subaccount #
POST /subaccounts/info Get subaccount info #
POST /subaccounts/update Update subaccount #
POST /subaccounts/delete Delete subaccount #
POST /subaccounts/pause Pause subaccount #
POST /subaccounts/resume Resume subaccount #

Documentation

📖
Documentation
https://mailchimp.com/developer/marketing/docs/fundamentals/
📖
APIReference
https://mailchimp.com/developer/marketing/api/
📖
GettingStarted
https://mailchimp.com/developer/marketing/guides/quick-start/
📖
Authentication
https://mailchimp.com/developer/marketing/guides/access-user-data-oauth-2/
📖
Documentation
https://mailchimp.com/developer/transactional/docs/fundamentals/
📖
GettingStarted
https://mailchimp.com/developer/transactional/guides/quick-start/
📖
Authentication
https://mailchimp.com/developer/transactional/docs/authentication-delivery/
📖
APIReference
https://mailchimp.com/developer/transactional/api/
📖
GettingStarted
https://mailchimp.com/developer/transactional/guides/send-first-email/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/mailchimp/refs/heads/main/openapi/mailchimp-subaccounts-api-openapi.yml
⚙
AsyncAPI
https://raw.githubusercontent.com/api-evangelist/mailchimp/refs/heads/main/asyncapi/mailchimp-marketing-webhooks-asyncapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/mailchimp/refs/heads/main/json-schema/campaign.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/mailchimp/refs/heads/main/json-schema/audience.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/mailchimp/refs/heads/main/json-schema/member.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/mailchimp/refs/heads/main/json-schema/template.json

Other Resources

🔗
JSONLD
https://raw.githubusercontent.com/api-evangelist/mailchimp/refs/heads/main/json-ld/context.jsonld
🔗
Integrations
https://mailchimp.com/developer/marketing/docs/integrations/
🔗
ErrorCodes
https://mailchimp.com/developer/marketing/docs/errors/
🔗
E-Commerce
https://mailchimp.com/developer/marketing/docs/e-commerce/
🔗
Methods and Parameters
https://mailchimp.com/developer/marketing/docs/methods-parameters/
🔗
Webhooks
https://mailchimp.com/developer/transactional/docs/webhooks/
🔗
Outbound Email
https://mailchimp.com/developer/transactional/docs/outbound-email/
🔗
Tags and Metadata
https://mailchimp.com/developer/transactional/docs/tags-metadata/

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/mailchimp-subaccounts-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

mailchimp-subaccounts-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  version: 1.4.1
  title: Mailchimp Transactional Subaccounts API
  contact:
    name: API Support
    email: apihelp@mailchimp.com
  x-permalink: https://github.com/mailchimp/mailchimp-client-lib-codegen/blob/main/spec/transactional.openapi.json
servers:
- url: https://mandrillapp.com/api/1.3
tags:
- name: subaccounts
paths:
  /subaccounts/list:
    post:
      x-custom-config:
        methodNameCamel: list
        methodNameSnake: list
      summary: List subaccounts
      description: Get the list of subaccounts defined for the account, optionally filtered by a prefix.
      operationId: postSubaccountsList
      tags:
      - subaccounts
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: array
                description: the subaccounts for the account, up to a maximum of 1,000
                items:
                  type: object
                  description: the individual subaccount info
                  properties:
                    id:
                      type: string
                      description: a unique indentifier for the subaccount
                      example: my_subaccount_id
                    name:
                      type: string
                      description: an optional display name for the subaccount
                      example: My Subaccount
                    custom_quota:
                      type: integer
                      description: an optional manual hourly quota for the subaccount. If not specified, the hourly quota will be managed based on reputation
                      example: 500
                    status:
                      type: string
                      description: the current sending status of the subaccount
                      enum:
                      - active
                      - paused
                      example: active
                    reputation:
                      type: integer
                      description: the subaccount's current reputation on a scale from 0 to 100
                      minimum: 0
                      maximum: 100
                      example: 95
                    created_at:
                      type: string
                      format: date-time
                      description: the date and time that the subaccount was created as a UTC string in YYYY-MM-DD HH:MM:SS format
                      example: '2025-04-15 12:00:00'
                    first_sent_at:
                      type: string
                      format: date-time
                      description: the date and time that the subaccount first sent as a UTC string in YYYY-MM-DD HH:MM:SS format
                      example: '2025-04-20 15:31:00'
                    sent_weekly:
                      type: integer
                      description: the number of emails the subaccount has sent so far this week (weeks start on midnight Monday, UTC)
                      example: 1500
                    sent_monthly:
                      type: integer
                      description: the number of emails the subaccount has sent so far this month (months start on midnight of the 1st, UTC)
                      example: 6000
                    sent_total:
                      type: integer
                      description: the number of emails the subaccount has sent since it was created
                      example: 10000
            application/x-php:
              schema:
                type: array
                description: the subaccounts for the account, up to a maximum of 1,000
                items:
                  type: object
                  description: the individual subaccount info
                  properties:
                    id:
                      type: string
                      description: a unique indentifier for the subaccount
                      example: my_subaccount_id
                    name:
                      type: string
                      description: an optional display name for the subaccount
                      example: My Subaccount
                    custom_quota:
                      type: integer
                      description: an optional manual hourly quota for the subaccount. If not specified, the hourly quota will be managed based on reputation
                      example: 500
                    status:
                      type: string
                      description: the current sending status of the subaccount
                      enum:
                      - active
                      - paused
                      example: active
                    reputation:
                      type: integer
                      description: the subaccount's current reputation on a scale from 0 to 100
                      minimum: 0
                      maximum: 100
                      example: 95
                    created_at:
                      type: string
                      format: date-time
                      description: the date and time that the subaccount was created as a UTC string in YYYY-MM-DD HH:MM:SS format
                      example: '2025-04-15 12:00:00'
                    first_sent_at:
                      type: string
                      format: date-time
                      description: the date and time that the subaccount first sent as a UTC string in YYYY-MM-DD HH:MM:SS format
                      example: '2025-04-20 15:31:00'
                    sent_weekly:
                      type: integer
                      description: the number of emails the subaccount has sent so far this week (weeks start on midnight Monday, UTC)
                      example: 1500
                    sent_monthly:
                      type: integer
                      description: the number of emails the subaccount has sent so far this month (months start on midnight of the 1st, UTC)
                      example: 6000
                    sent_total:
                      type: integer
                      description: the number of emails the subaccount has sent since it was created
                      example: 10000
            application/x-yaml; charset=utf-8:
              schema:
                type: array
                description: the subaccounts for the account, up to a maximum of 1,000
                items:
                  type: object
                  description: the individual subaccount info
                  properties:
                    id:
                      type: string
                      description: a unique indentifier for the subaccount
                      example: my_subaccount_id
                    name:
                      type: string
                      description: an optional display name for the subaccount
                      example: My Subaccount
                    custom_quota:
                      type: integer
                      description: an optional manual hourly quota for the subaccount. If not specified, the hourly quota will be managed based on reputation
                      example: 500
                    status:
                      type: string
                      description: the current sending status of the subaccount
                      enum:
                      - active
                      - paused
                      example: active
                    reputation:
                      type: integer
                      description: the subaccount's current reputation on a scale from 0 to 100
                      minimum: 0
                      maximum: 100
                      example: 95
                    created_at:
                      type: string
                      format: date-time
                      description: the date and time that the subaccount was created as a UTC string in YYYY-MM-DD HH:MM:SS format
                      example: '2025-04-15 12:00:00'
                    first_sent_at:
                      type: string
                      format: date-time
                      description: the date and time that the subaccount first sent as a UTC string in YYYY-MM-DD HH:MM:SS format
                      example: '2025-04-20 15:31:00'
                    sent_weekly:
                      type: integer
                      description: the number of emails the subaccount has sent so far this week (weeks start on midnight Monday, UTC)
                      example: 1500
                    sent_monthly:
                      type: integer
                      description: the number of emails the subaccount has sent so far this month (months start on midnight of the 1st, UTC)
                      example: 6000
                    sent_total:
                      type: integer
                      description: the number of emails the subaccount has sent since it was created
                      example: 10000
      deprecated: false
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
              - key
              properties:
                key:
                  type: string
                  description: a valid api key
                q:
                  type: string
                  description: an optional prefix to filter the subaccounts' ids and names
        required: true
  /subaccounts/add:
    post:
      x-custom-config:
        methodNameCamel: add
        methodNameSnake: add
      summary: Add subaccount
      description: Add a new subaccount.
      operationId: postSubaccountsAdd
      tags:
      - subaccounts
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                description: the information saved about the new subaccount
                properties:
                  id:
                    type: string
                    description: a unique indentifier for the subaccount
                    example: my_subaccount_id
                  name:
                    type: string
                    description: an optional display name for the subaccount
                    example: My Subaccount
                  custom_quota:
                    type: integer
                    description: an optional manual hourly quota for the subaccount. If not specified, the hourly quota will be managed based on reputation
                    example: 500
                  status:
                    type: string
                    description: the current sending status of the subaccount
                    enum:
                    - active
                    - paused
                    example: active
                  reputation:
                    type: integer
                    description: the subaccount's current reputation on a scale from 0 to 100
                    minimum: 0
                    maximum: 100
                    example: 50
                  created_at:
                    type: string
                    format: date-time
                    description: the date and time that the subaccount was created as a UTC string in YYYY-MM-DD HH:MM:SS format
                    example: '2025-04-15 12:00:00'
                  first_sent_at:
                    type: string
                    format: date-time
                    description: the date and time that the subaccount first sent as a UTC string in YYYY-MM-DD HH:MM:SS format
                    example: '2025-04-20 15:31:00'
                  sent_weekly:
                    type: integer
                    description: the number of emails the subaccount has sent so far this week (weeks start on midnight Monday, UTC)
                    example: 0
                  sent_monthly:
                    type: integer
                    description: the number of emails the subaccount has sent so far this month (months start on midnight of the 1st, UTC)
                    example: 0
                  sent_total:
                    type: integer
                    description: the number of emails the subaccount has sent since it was created
                    example: 0
            application/x-php:
              schema:
                type: object
                description: the information saved about the new subaccount
                properties:
                  id:
                    type: string
                    description: a unique indentifier for the subaccount
                    example: my_subaccount_id
                  name:
                    type: string
                    description: an optional display name for the subaccount
                    example: My Subaccount
                  custom_quota:
                    type: integer
                    description: an optional manual hourly quota for the subaccount. If not specified, the hourly quota will be managed based on reputation
                    example: 500
                  status:
                    type: string
                    description: the current sending status of the subaccount
                    enum:
                    - active
                    - paused
                    example: active
                  reputation:
                    type: integer
                    description: the subaccount's current reputation on a scale from 0 to 100
                    minimum: 0
                    maximum: 100
                    example: 50
                  created_at:
                    type: string
                    format: date-time
                    description: the date and time that the subaccount was created as a UTC string in YYYY-MM-DD HH:MM:SS format
                    example: '2025-04-15 12:00:00'
                  first_sent_at:
                    type: string
                    format: date-time
                    description: the date and time that the subaccount first sent as a UTC string in YYYY-MM-DD HH:MM:SS format
                    example: '2025-04-20 15:31:00'
                  sent_weekly:
                    type: integer
                    description: the number of emails the subaccount has sent so far this week (weeks start on midnight Monday, UTC)
                    example: 0
                  sent_monthly:
                    type: integer
                    description: the number of emails the subaccount has sent so far this month (months start on midnight of the 1st, UTC)
                    example: 0
                  sent_total:
                    type: integer
                    description: the number of emails the subaccount has sent since it was created
                    example: 0
            application/x-yaml; charset=utf-8:
              schema:
                type: object
                description: the information saved about the new subaccount
                properties:
                  id:
                    type: string
                    description: a unique indentifier for the subaccount
                    example: my_subaccount_id
                  name:
                    type: string
                    description: an optional display name for the subaccount
                    example: My Subaccount
                  custom_quota:
                    type: integer
                    description: an optional manual hourly quota for the subaccount. If not specified, the hourly quota will be managed based on reputation
                    example: 500
                  status:
                    type: string
                    description: the current sending status of the subaccount
                    enum:
                    - active
                    - paused
                    example: active
                  reputation:
                    type: integer
                    description: the subaccount's current reputation on a scale from 0 to 100
                    minimum: 0
                    maximum: 100
                    example: 50
                  created_at:
                    type: string
                    format: date-time
                    description: the date and time that the subaccount was created as a UTC string in YYYY-MM-DD HH:MM:SS format
                    example: '2025-04-15 12:00:00'
                  first_sent_at:
                    type: string
                    format: date-time
                    description: the date and time that the subaccount first sent as a UTC string in YYYY-MM-DD HH:MM:SS format
                    example: '2025-04-20 15:31:00'
                  sent_weekly:
                    type: integer
                    description: the number of emails the subaccount has sent so far this week (weeks start on midnight Monday, UTC)
                    example: 0
                  sent_monthly:
                    type: integer
                    description: the number of emails the subaccount has sent so far this month (months start on midnight of the 1st, UTC)
                    example: 0
                  sent_total:
                    type: integer
                    description: the number of emails the subaccount has sent since it was created
                    example: 0
      deprecated: false
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
              - key
              - id
              properties:
                key:
                  type: string
                  description: a valid api key
                id:
                  type: string
                  description: a unique identifier for the subaccount to be used in sending calls
                  maxLength: 255
                name:
                  type: string
                  description: an optional display name to further identify the subaccount
                  maxLength: 1024
                notes:
                  type: string
                  description: optional extra text to associate with the subaccount
                custom_quota:
                  type: integer
                  description: an optional manual hourly quota for the subaccount. If not specified, Mandrill will manage this based on reputation
                  minimum: 0
        required: true
  /subaccounts/info:
    post:
      x-custom-config:
        methodNameCamel: info
        methodNameSnake: info
      summary: Get subaccount info
      description: Given the ID of an existing subaccount, return the data about it.
      operationId: postSubaccountsInfo
      tags:
      - subaccounts
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                description: the information about the subaccount
                properties:
                  id:
                    type: string
                    description: a unique indentifier for the subaccount
                    example: my_subaccount_id
                  name:
                    type: string
                    description: an optional display name for the subaccount
                    example: My Subaccount
                  notes:
                    type: string
                    description: optional extra text to associate with the subaccount
                    example: This is my subaccount for order receipts
                  custom_quota:
                    type: integer
                    description: an optional manual hourly quota for the subaccount. If not specified, the hourly quota will be managed based on reputation
                    example: 500
                  status:
                    type: string
                    description: the current sending status of the subaccount
                    enum:
                    - active
                    - paused
                    example: active
                  reputation:
                    type: integer
                    description: the subaccount's current reputation on a scale from 0 to 100
                    minimum: 0
                    maximum: 100
                    example: 95
                  created_at:
                    type: string
                    format: date-time
                    description: the date and time that the subaccount was created as a UTC string in YYYY-MM-DD HH:MM:SS format
                    example: '2025-04-15 12:00:00'
                  first_sent_at:
                    type: string
                    format: date-time
                    description: the date and time that the subaccount first sent as a UTC string in YYYY-MM-DD HH:MM:SS format
                    example: '2025-04-20 15:31:00'
                  sent_weekly:
                    type: integer
                    description: the number of emails the subaccount has sent so far this week (weeks start on midnight Monday, UTC)
                    example: 1500
                  sent_monthly:
                    type: integer
                    description: the number of emails the subaccount has sent so far this month (months start on midnight of the 1st, UTC)
                    example: 6000
                  sent_total:
                    type: integer
                    description: the number of emails the subaccount has sent since it was created
                    example: 10000
                  sent_hourly:
                    type: integer
                    description: the number of emails the subaccount has sent in the last hour
                    example: 200
                  hourly_quota:
                    type: integer
                    description: the current hourly quota for the subaccount, either manual or reputation-based
                    example: 500
                  last_30_days:
                    type: object
                    description: stats for this subaccount in the last 30 days
                    properties:
                      sent:
                        type: integer
                        description: the number of emails sent for this subaccount in the last 30 days
                        example: 300
                      hard_bounces:
                        type: integer
                        description: the number of emails hard bounced for this subaccount in the last 30 days
                        example: 5
                      soft_bounces:
                        type: integer
                        description: the number of emails soft bounced for this subaccount in the last 30 days
                        example: 10
                      rejects:
                        type: integer
                        description: the number of emails rejected for sending this subaccount in the last 30 days
                        example: 2
                      complaints:
                        type: integer
                        description: the number of spam complaints for this subaccount in the last 30 days
                        example: 1
                      unsubs:
                        type: integer
                        description: the number of unsbuscribes for this subaccount in the last 30 days
                        example: 0
                      opens:
                        type: integer
                        description: the number of times emails have been opened for this subaccount in the last 30 days
                        example: 1000
                      unique_opens:
                        type: integer
                        description: the number of unique opens for emails sent for this subaccount in the last 30 days
                        example: 800
                      clicks:
                        type: integer
                        description: the number of URLs that have been clicked for this subaccount in the last 30 days
                        example: 500
                      unique_clicks:
                        type: integer
                        description: the number of unique clicks for emails sent for this subaccount in the last 30 days
                        example: 300
            application/x-php:
              schema:
                type: object
                description: the information about the subaccount
                properties:
                  id:
                    type: string
                    description: a unique indentifier for the subaccount
                    example: my_subaccount_id
                  name:
                    type: string
                    description: an optional display name for the subaccount
                    example: My Subaccount
                  notes:
                    type: string
                    description: optional extra text to associate with the subaccount
                    example: This is my subaccount for order receipts
                  custom_quota:
                    type: integer
                    description: an optional manual hourly quota for the subaccount. If not specified, the hourly quota will be managed based on reputation
                    example: 500
                  status:
                    type: string
                    description: the current sending status of the subaccount
                    enum:
                    - active
                    - paused
                    example: active
                  reputation:
                    type: integer
                    description: the subaccount's current reputation on a scale from 0 to 100
                    minimum: 0
                    maximum: 100
                    example: 95
                  created_at:
                    type: string
                    format: date-time
                    description: the date and time that the subaccount was created as a UTC string in YYYY-MM-DD HH:MM:SS format
                    example: '2025-04-15 12:00:00'
                  first_sent_at:
                    type: string
                    format: date-time
                    description: the date and time that the subaccount first sent as a UTC string in YYYY-MM-DD HH:MM:SS format
                    example: '2025-04-20 15:31:00'
                  sent_weekly:
                    type: integer
                    description: the number of emails the subaccount has sent so far this week (weeks start on midnight Monday, UTC)
                    example: 1500
                  sent_monthly:
                    type: integer
                    description: the number of emails the subaccount has sent so far this month (months start on midnight of the 1st, UTC)
                    example: 6000
                  sent_total:
                    type: integer
                    description: the number of emails the subaccount has sent since it was created
                    example: 10000
                  sent_hourly:
                    type: integer
                    description: the number of emails the subaccount has sent in the last hour
                    example: 200
                  hourly_quota:
                    type: integer
                    description: the current hourly quota for the subaccount, either manual or reputation-based
                    example: 500
                  last_30_days:
                    type: object
                    description: stats for this subaccount in the last 30 days
                    properties:
                      sent:
                        type: integer
                        description: the number of emails sent for this subaccount in the last 30 days
                        example: 300
                      hard_bounces:
                        type: integer
                        description: the number of emails hard bounced for this subaccount in the last 30 days
                        example: 5
                      soft_bounces:
                        type: integer
                        description: the number of emails soft bounced for this subaccount in the last 30 days
                        example: 10
                      rejects:
                        type: integer
                        description: the number of emails rejected for sending this subaccount in the last 30 days
                        example: 2
                      complaints:
                        type: integer
                        description: the number of spam complaints for this subaccount in the last 30 days
                        example: 1
                      unsubs:
                        type: integer
                        description: the number of unsbuscribes for this subaccount in the last 30 days
                        example: 0
                      opens:
                        type: integer
                        description: the number of times emails have been opened for this subaccount in the last 30 days
                        example: 1000
                      unique_opens:
                        type: integer
                        description: the number of unique opens for emails sent for this subaccount in the last 30 days
                        example: 800
                      clicks:
                        type: integer
                        description: the number of URLs that have been clicked for this subaccount in the last 30 days
                        example: 500
                      unique_clicks:
                        type: integer
                        description: the number of unique clicks for emails sent for this subaccount in the last 30 days
                        example: 300
            application/x-yaml; charset=utf-8:
              schema:
                type: object
                description: the information about the subaccount
                properties:
                  id:
                    type: string
                    description: a unique indentifier for the subaccount
                    example: my_subaccount_id
                  name:
                    type: string
                    description: an optional display name for the subaccount
                    example: My Subaccount
                  notes:
                    type: string
                    description: optional extra text to associate with the subaccount
                    example: This is my subaccount for order receipts
                  custom_quota:
                    type: integer
                    description: an optional manual hourly quota for the subaccount. If not specified, the hourly quota will be managed based on reputation
                    example: 500
                  status:
                    type: string
                    description: the current sending status of the subaccount
                    enum:
                    - active
                    - paused
                    example: active
                  reputation:
                    type: integer
                    description: the subaccount's current reputation on a scale from 0 to 100
                    minimum: 0
                    maximum: 100
                    example: 95
                  created_at:
                    type: string
                    format: date-time
                    description: the date and time that the subaccount was created as a UTC string in YYYY-MM-DD HH:MM:SS format
                    example: '2025-04-15 12:00:00'
                  first_sent_at:
                    type: string
                    format: date-time
                    description: the date and time that the subaccount first sent as a UTC string in YYYY-MM-DD HH:MM:SS format
                    example: '2025-04-20 15:31:00'
                  sent_weekly:
                    type: integer
                    description: the number of emails the subaccount has sent so far this week (weeks start on midnight Monday, UTC)
                    example: 1500
                  sent_monthly:
                    type: integer
                    description: the number of emails the subaccount has sent so far this month (months start on midnight of the 1st, UTC)
                    example: 6000
                  sent_total:
                    type: integer
                    description: the number of emails the subaccount has sent since it was created
                    example: 10000
                  sent_hourly:
                    type: integer
               

# --- truncated at 32 KB (73 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/mailchimp/refs/heads/main/openapi/mailchimp-subaccounts-api-openapi.yml