Mailchimp

Mailchimp Allow Lists API

The Allow Lists API from Mailchimp — 3 operation(s) for allow lists.

GitHub OpenAPI

Operations 3

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /allowlists/add Add an email address to the allowlist · Add email to allowlist #
Ask an LLM
“How do I make sure transactional mail to a specific address is never rejected?”
“If an address is on my denylist, does adding it to the allowlist clear that entry?”
Tell an agent
Add {email} to my rejection allowlist using key {key}.
Allowlist {email} with the note {comment}, API key {key}.
POST /allowlists/list List or search allowlisted addresses · List allowlisted emails #
Ask an LLM
“Which email addresses are on my rejection allowlist?”
“Can I search the allowlist by an address prefix, and how many results come back?”
Tell an agent
Show my allowlisted email addresses using key {key}.
Search the allowlist for addresses starting with {email}, API key {key}.
POST /allowlists/delete Remove an address from the allowlist · Remove email from allowlist #
Ask an LLM
“Can I take an email address back off my allowlist?”
“What's the way to un-allowlist an address that shouldn't be exempt anymore?”
Tell an agent destructive · confirm first
Remove {email} from the allowlist using key {key}.
Delete the allowlist entry for {email}, API key {key}.

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://artifacts.apis.io/mailchimp/openapi/mailchimp-allow-lists-api-openapi.yml
⚙
AsyncAPI
https://artifacts.apis.io/mailchimp/asyncapi/mailchimp-marketing-webhooks-asyncapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/mailchimp/json-schema/campaign.json
📊
JSONSchema
https://artifacts.apis.io/mailchimp/json-schema/audience.json
📊
JSONSchema
https://artifacts.apis.io/mailchimp/json-schema/member.json
📊
JSONSchema
https://artifacts.apis.io/mailchimp/json-schema/template.json

Other Resources

🔗
JSONLD
https://artifacts.apis.io/mailchimp/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:mailchimp-allow-lists-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

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

OpenAPI Specification

mailchimp-allow-lists-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  version: 1.4.1
  title: Mailchimp Transactional Allowlists 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: Allow Lists
paths:
  /allowlists/add:
    post:
      x-custom-config:
        methodNameCamel: add
        methodNameSnake: add
      summary: Add email to allowlist
      description: Adds an email to your email rejection allowlist. If the address is currently on your denylist, that denylist entry will be removed automatically.
      operationId: postAllowlistsAdd
      tags:
      - Allow Lists
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                description: a status object containing the address and the result of the operation
                properties:
                  email:
                    type: string
                    description: the email address you provided
                    example: user@example.com
                  added:
                    type: boolean
                    description: whether the operation succeeded
                    example: true
            application/x-php:
              schema:
                type: object
                description: a status object containing the address and the result of the operation
                properties:
                  email:
                    type: string
                    description: the email address you provided
                    example: user@example.com
                  added:
                    type: boolean
                    description: whether the operation succeeded
                    example: true
            application/x-yaml; charset=utf-8:
              schema:
                type: object
                description: a status object containing the address and the result of the operation
                properties:
                  email:
                    type: string
                    description: the email address you provided
                    example: user@example.com
                  added:
                    type: boolean
                    description: whether the operation succeeded
                    example: true
      deprecated: false
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
              - key
              - email
              properties:
                key:
                  type: string
                  description: a valid api key
                email:
                  type: string
                  description: an email address to add to the allowlist
                  format: email
                comment:
                  type: string
                  description: an optional description of why the email was added to the allowlist
                  maxLength: 255
        required: true
  /allowlists/list:
    post:
      x-custom-config:
        methodNameCamel: list
        methodNameSnake: list
      summary: List allowlisted emails
      description: Retrieves your email rejection allowlist. You can provide an email address or search prefix to limit the results. Returns up to 1000 results.
      operationId: postAllowlistsList
      tags:
      - Allow Lists
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: array
                description: up to 1000 allowlist entries
                items:
                  type: object
                  description: the information for each allowlist entry
                  properties:
                    email:
                      type: string
                      format: email
                      description: the email that is allowlisted
                      example: user@example.com
                    detail:
                      type: string
                      description: a description of why the email was allowlisted
                      example: Added manually via the API
                    created_at:
                      type: string
                      format: date-time
                      description: when the email was added to the allowlist
                      example: '2025-04-29 18:47:35'
            application/x-php:
              schema:
                type: array
                description: up to 1000 allowlist entries
                items:
                  type: object
                  description: the information for each allowlist entry
                  properties:
                    email:
                      type: string
                      format: email
                      description: the email that is allowlisted
                      example: user@example.com
                    detail:
                      type: string
                      description: a description of why the email was allowlisted
                      example: Added manually via the API
                    created_at:
                      type: string
                      format: date-time
                      description: when the email was added to the allowlist
                      example: '2025-04-29 18:47:35'
            application/x-yaml; charset=utf-8:
              schema:
                type: array
                description: up to 1000 allowlist entries
                items:
                  type: object
                  description: the information for each allowlist entry
                  properties:
                    email:
                      type: string
                      format: email
                      description: the email that is allowlisted
                      example: user@example.com
                    detail:
                      type: string
                      description: a description of why the email was allowlisted
                      example: Added manually via the API
                    created_at:
                      type: string
                      format: date-time
                      description: when the email was added to the allowlist
                      example: '2025-04-29 18:47:35'
      deprecated: false
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
              - key
              properties:
                key:
                  type: string
                  description: a valid api key
                email:
                  type: string
                  description: an optional email address or prefix to search by
                  format: email
        required: true
  /allowlists/delete:
    post:
      x-custom-config:
        methodNameCamel: delete
        methodNameSnake: delete
      summary: Remove email from allowlist
      description: Removes an email address from the allowlist.
      operationId: postAllowlistsDelete
      tags:
      - Allow Lists
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                description: a status object containing the address and whether the deletion succeeded
                properties:
                  email:
                    type: string
                    description: the email address that was removed from the denylist
                    example: user@example.com
                  deleted:
                    type: boolean
                    description: whether the address was deleted successfully
                    example: true
            application/x-php:
              schema:
                type: object
                description: a status object containing the address and whether the deletion succeeded
                properties:
                  email:
                    type: string
                    description: the email address that was removed from the denylist
                    example: user@example.com
                  deleted:
                    type: boolean
                    description: whether the address was deleted successfully
                    example: true
            application/x-yaml; charset=utf-8:
              schema:
                type: object
                description: a status object containing the address and whether the deletion succeeded
                properties:
                  email:
                    type: string
                    description: the email address that was removed from the denylist
                    example: user@example.com
                  deleted:
                    type: boolean
                    description: whether the address was deleted successfully
                    example: true
      deprecated: false
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
              - key
              - email
              properties:
                key:
                  type: string
                  description: a valid api key
                email:
                  type: string
                  description: the email address to remove from the allowlist
                  format: email
        required: true
x-doc-structure:
  resources:
    allowlists:
      title: Allowlists
      description: Add, list, or delete from your Rejection Allowlist.
      paths:
      - /allowlists/add
      - /allowlists/list
      - /allowlists/delete
    exports:
      title: Exports
      description: Start an export, or get information on export jobs in progress.
      paths:
      - /exports/info
      - /exports/list
      - /exports/rejects
      - /exports/whitelist
      - /exports/allowlist
      - /exports/activity
    inbound:
      title: Inbound
      description: Manage your inbound domains and routes.
      paths:
      - /inbound/domains
      - /inbound/add-domain
      - /inbound/check-domain
      - /inbound/delete-domain
      - /inbound/routes
      - /inbound/add-route
      - /inbound/update-route
      - /inbound/delete-route
      - /inbound/send-raw
    ips:
      title: IPs
      description: Request and manage Dedicated IPs for your account, and set up reverse DNS.
      paths:
      - /ips/list
      - /ips/info
      - /ips/provision
      - /ips/start-warmup
      - /ips/cancel-warmup
      - /ips/set-pool
      - /ips/delete
      - /ips/list-pools
      - /ips/pool-info
      - /ips/create-pool
      - /ips/delete-pool
      - /ips/check-custom-dns
      - /ips/set-custom-dns
    messages:
      title: Messages
      description: Send, schedule, or get information on your emails.
      paths:
      - /messages/send
      - /messages/send-sms
      - /messages/send-template
      - /messages/send-mc-template
      - /messages/search
      - /messages/search-time-series
      - /messages/info
      - /messages/content
      - /messages/parse
      - /messages/send-raw
      - /messages/list-scheduled
      - /messages/cancel-scheduled
      - /messages/reschedule
    metadata:
      title: Metadata
      description: Manage your custom metadata fields in your account.
      paths:
      - /metadata/list
      - /metadata/add
      - /metadata/update
      - /metadata/delete
    rejects:
      title: Rejects
      description: Add, list, or delete from your Rejection Denylist.
      paths:
      - /rejects/add
      - /rejects/add-sms
      - /rejects/delete
      - /rejects/delete-sms
      - /rejects/list
      - /rejects/list-sms
    senders:
      title: Senders
      description: Manage or get information about your sending domains.
      paths:
      - /senders/list
      - /senders/domains
      - /senders/add-domain
      - /senders/delete-domain
      - /senders/check-domain
      - /senders/verify-domain
      - /senders/info
      - /senders/time-series
    subaccounts:
      title: Subaccounts
      description: Manage your subaccounts, including the abilitiy to pause and resume sending.
      paths:
      - /subaccounts/list
      - /subaccounts/add
      - /subaccounts/info
      - /subaccounts/update
      - /subaccounts/delete
      - /subaccounts/pause
      - /subaccounts/resume
    tags:
      title: Tags
      description: List, delete, or get information on your Tags and their sending statistics.
      paths:
      - /tags/list
      - /tags/delete
      - /tags/info
      - /tags/time-series
      - /tags/all-time-series
    templates:
      title: Templates
      description: Manage templates created via the Mandrill UI or through the /templates endpoint.
      paths:
      - /templates/add
      - /templates/info
      - /templates/update
      - /templates/publish
      - /templates/delete
      - /templates/list
      - /templates/time-series
      - /templates/render
    mctemplates:
      title: Templates (MC)
      description: Manage templates created via the Mailchimp UI.
      paths:
      - /mctemplates/info
      - /mctemplates/list
      - /mctemplates/time-series
      - /mctemplates/render
    urls:
      title: URLs
      description: Manage your tracking domains.
      paths:
      - /urls/add-tracking-domain
      - /urls/check-tracking-domain
      - /urls/delete-tracking-domain
      - /urls/tracking-domains
    users:
      title: Users
      description: Get information about your account, or ping Transactional.
      paths:
      - /users/info
      - /users/ping
      - /users/ping2
      - /users/senders
    webhooks:
      title: Webhooks
      description: Manage the webhooks in your account.
      paths:
      - /webhooks/list
      - /webhooks/add
      - /webhooks/info
      - /webhooks/update
      - /webhooks/delete