Mailchimp

Mailchimp Webhooks API

The Webhooks API from Mailchimp — 9 operation(s) for webhooks.

GitHub OpenAPI

Operations 5

POST /webhooks/list List webhooks #
POST /webhooks/add Add webhook #
POST /webhooks/info Get webhook info #
POST /webhooks/update Update webhook #
POST /webhooks/delete Delete webhook #

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-webhooks-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-webhooks-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-webhooks-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  version: 1.4.1
  title: Mailchimp Transactional Webhooks 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: webhooks
paths:
  /webhooks/list:
    post:
      x-custom-config:
        methodNameCamel: list
        methodNameSnake: list
      summary: List webhooks
      description: Get the list of all webhooks defined on the account.
      operationId: postWebhooksList
      tags:
      - webhooks
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: array
                description: the webhooks associated with the account
                items:
                  type: object
                  description: the individual webhook info
                  properties:
                    id:
                      type: integer
                      description: a unique integer indentifier for the webhook
                      example: 1131
                    url:
                      type: string
                      description: The URL that the event data will be posted to
                      example: http://example.com/webhook
                    description:
                      type: string
                      description: a description of the webhook
                      example: My webhook
                    auth_key:
                      type: string
                      description: the key used to requests for this webhook
                      example: UHeOnTqMBMGqAEMadhA6xQ
                    events:
                      type: array
                      description: The message events that will be posted to the hook
                      items:
                        type: string
                        description: the individual message event
                        enum:
                        - send
                        - hard_bounce
                        - soft_bounce
                        - open
                        - click
                        - spam
                        - unsub
                        - reject
                        example: send
                    created_at:
                      type: string
                      format: date-time
                      description: the date and time that the webhook was created as a UTC string in YYYY-MM-DD HH:MM:SS format
                      example: '2025-04-29 12:00:00'
                    last_sent_at:
                      type: string
                      format: date-time
                      description: the date and time that the webhook last successfully received events as a UTC string in YYYY-MM-DD HH:MM:SS format
                      example: '2025-04-29 14:00:00'
                    batches_sent:
                      type: integer
                      description: the number of event batches that have ever been sent to this webhook
                      example: 4105
                    events_sent:
                      type: integer
                      description: the total number of events that have ever been sent to this webhook
                      example: 10000
                    last_error:
                      type: string
                      description: if we've ever gotten an error trying to post to this webhook, the last error that we've seen
                      example: Connection timed out
            application/x-php:
              schema:
                type: array
                description: the webhooks associated with the account
                items:
                  type: object
                  description: the individual webhook info
                  properties:
                    id:
                      type: integer
                      description: a unique integer indentifier for the webhook
                      example: 1131
                    url:
                      type: string
                      description: The URL that the event data will be posted to
                      example: http://example.com/webhook
                    description:
                      type: string
                      description: a description of the webhook
                      example: My webhook
                    auth_key:
                      type: string
                      description: the key used to requests for this webhook
                      example: UHeOnTqMBMGqAEMadhA6xQ
                    events:
                      type: array
                      description: The message events that will be posted to the hook
                      items:
                        type: string
                        description: the individual message event
                        enum:
                        - send
                        - hard_bounce
                        - soft_bounce
                        - open
                        - click
                        - spam
                        - unsub
                        - reject
                        example: send
                    created_at:
                      type: string
                      format: date-time
                      description: the date and time that the webhook was created as a UTC string in YYYY-MM-DD HH:MM:SS format
                      example: '2025-04-29 12:00:00'
                    last_sent_at:
                      type: string
                      format: date-time
                      description: the date and time that the webhook last successfully received events as a UTC string in YYYY-MM-DD HH:MM:SS format
                      example: '2025-04-29 14:00:00'
                    batches_sent:
                      type: integer
                      description: the number of event batches that have ever been sent to this webhook
                      example: 4105
                    events_sent:
                      type: integer
                      description: the total number of events that have ever been sent to this webhook
                      example: 10000
                    last_error:
                      type: string
                      description: if we've ever gotten an error trying to post to this webhook, the last error that we've seen
                      example: Connection timed out
            application/x-yaml; charset=utf-8:
              schema:
                type: array
                description: the webhooks associated with the account
                items:
                  type: object
                  description: the individual webhook info
                  properties:
                    id:
                      type: integer
                      description: a unique integer indentifier for the webhook
                      example: 1131
                    url:
                      type: string
                      description: The URL that the event data will be posted to
                      example: http://example.com/webhook
                    description:
                      type: string
                      description: a description of the webhook
                      example: My webhook
                    auth_key:
                      type: string
                      description: the key used to requests for this webhook
                      example: UHeOnTqMBMGqAEMadhA6xQ
                    events:
                      type: array
                      description: The message events that will be posted to the hook
                      items:
                        type: string
                        description: the individual message event
                        enum:
                        - send
                        - hard_bounce
                        - soft_bounce
                        - open
                        - click
                        - spam
                        - unsub
                        - reject
                        example: send
                    created_at:
                      type: string
                      format: date-time
                      description: the date and time that the webhook was created as a UTC string in YYYY-MM-DD HH:MM:SS format
                      example: '2025-04-29 12:00:00'
                    last_sent_at:
                      type: string
                      format: date-time
                      description: the date and time that the webhook last successfully received events as a UTC string in YYYY-MM-DD HH:MM:SS format
                      example: '2025-04-29 14:00:00'
                    batches_sent:
                      type: integer
                      description: the number of event batches that have ever been sent to this webhook
                      example: 4105
                    events_sent:
                      type: integer
                      description: the total number of events that have ever been sent to this webhook
                      example: 10000
                    last_error:
                      type: string
                      description: if we've ever gotten an error trying to post to this webhook, the last error that we've seen
                      example: Connection timed out
      deprecated: false
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
              - key
              properties:
                key:
                  type: string
                  description: a valid api key
        required: true
  /webhooks/add:
    post:
      x-custom-config:
        methodNameCamel: add
        methodNameSnake: add
      summary: Add webhook
      description: Add a new webhook.
      operationId: postWebhooksAdd
      tags:
      - webhooks
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                description: the information saved about the new webhook
                properties:
                  id:
                    type: integer
                    description: a unique integer indentifier for the webhook
                    example: 1131
                  url:
                    type: string
                    description: The URL that the event data will be posted to
                    example: http://example.com/webhook
                  description:
                    type: string
                    description: a description of the webhook
                    example: My webhook
                  auth_key:
                    type: string
                    description: the key used to requests for this webhook
                    example: UHeOnTqMBMGqAEMadhA6xQ
                  events:
                    type: array
                    description: The message events that will be posted to the hook
                    items:
                      type: string
                      description: the individual message event
                      enum:
                      - send
                      - hard_bounce
                      - soft_bounce
                      - open
                      - click
                      - spam
                      - unsub
                      - reject
                      example: send
                  created_at:
                    type: string
                    format: date-time
                    description: the date and time that the webhook was created as a UTC string in YYYY-MM-DD HH:MM:SS format
                    example: '2025-04-29 12:00:00'
                  last_sent_at:
                    type: string
                    format: date-time
                    description: the date and time that the webhook last successfully received events as a UTC string in YYYY-MM-DD HH:MM:SS format
                    example: '2025-04-29 14:00:00'
                  batches_sent:
                    type: integer
                    description: the number of event batches that have ever been sent to this webhook
                    example: 0
                  events_sent:
                    type: integer
                    description: the total number of events that have ever been sent to this webhook
                    example: 0
                  last_error:
                    type: string
                    description: if we've ever gotten an error trying to post to this webhook, the last error that we've seen
                    example: Connection timed out
            application/x-php:
              schema:
                type: object
                description: the information saved about the new webhook
                properties:
                  id:
                    type: integer
                    description: a unique integer indentifier for the webhook
                    example: 1131
                  url:
                    type: string
                    description: The URL that the event data will be posted to
                    example: http://example.com/webhook
                  description:
                    type: string
                    description: a description of the webhook
                    example: My webhook
                  auth_key:
                    type: string
                    description: the key used to requests for this webhook
                    example: UHeOnTqMBMGqAEMadhA6xQ
                  events:
                    type: array
                    description: The message events that will be posted to the hook
                    items:
                      type: string
                      description: the individual message event
                      enum:
                      - send
                      - hard_bounce
                      - soft_bounce
                      - open
                      - click
                      - spam
                      - unsub
                      - reject
                      example: send
                  created_at:
                    type: string
                    format: date-time
                    description: the date and time that the webhook was created as a UTC string in YYYY-MM-DD HH:MM:SS format
                    example: '2025-04-29 12:00:00'
                  last_sent_at:
                    type: string
                    format: date-time
                    description: the date and time that the webhook last successfully received events as a UTC string in YYYY-MM-DD HH:MM:SS format
                    example: '2025-04-29 14:00:00'
                  batches_sent:
                    type: integer
                    description: the number of event batches that have ever been sent to this webhook
                    example: 0
                  events_sent:
                    type: integer
                    description: the total number of events that have ever been sent to this webhook
                    example: 0
                  last_error:
                    type: string
                    description: if we've ever gotten an error trying to post to this webhook, the last error that we've seen
                    example: Connection timed out
            application/x-yaml; charset=utf-8:
              schema:
                type: object
                description: the information saved about the new webhook
                properties:
                  id:
                    type: integer
                    description: a unique integer indentifier for the webhook
                    example: 1131
                  url:
                    type: string
                    description: The URL that the event data will be posted to
                    example: http://example.com/webhook
                  description:
                    type: string
                    description: a description of the webhook
                    example: My webhook
                  auth_key:
                    type: string
                    description: the key used to requests for this webhook
                    example: UHeOnTqMBMGqAEMadhA6xQ
                  events:
                    type: array
                    description: The message events that will be posted to the hook
                    items:
                      type: string
                      description: the individual message event
                      enum:
                      - send
                      - hard_bounce
                      - soft_bounce
                      - open
                      - click
                      - spam
                      - unsub
                      - reject
                      example: send
                  created_at:
                    type: string
                    format: date-time
                    description: the date and time that the webhook was created as a UTC string in YYYY-MM-DD HH:MM:SS format
                    example: '2025-04-29 12:00:00'
                  last_sent_at:
                    type: string
                    format: date-time
                    description: the date and time that the webhook last successfully received events as a UTC string in YYYY-MM-DD HH:MM:SS format
                    example: '2025-04-29 14:00:00'
                  batches_sent:
                    type: integer
                    description: the number of event batches that have ever been sent to this webhook
                    example: 0
                  events_sent:
                    type: integer
                    description: the total number of events that have ever been sent to this webhook
                    example: 0
                  last_error:
                    type: string
                    description: if we've ever gotten an error trying to post to this webhook, the last error that we've seen
                    example: Connection timed out
      deprecated: false
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
              - key
              - url
              properties:
                key:
                  type: string
                  description: a valid api key
                url:
                  type: string
                  description: the URL to POST batches of events
                description:
                  type: string
                  description: an optional description of the webhook
                events:
                  type: array
                  description: an optional list of events that will be posted to the webhook
                  items:
                    type: object
                    description: the individual event to listen for
                    enum:
                    - send
                    - hard_bounce
                    - soft_bounce
                    - open
                    - click
                    - spam
                    - unsub
                    - reject
                    - blacklist
                    - whitelist
        required: true
  /webhooks/info:
    post:
      x-custom-config:
        methodNameCamel: info
        methodNameSnake: info
      summary: Get webhook info
      description: Given the ID of an existing webhook, return the data about it.
      operationId: postWebhooksInfo
      tags:
      - webhooks
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                description: the information about the webhook
                properties:
                  id:
                    type: integer
                    description: a unique integer indentifier for the webhook
                    example: 1131
                  url:
                    type: string
                    description: The URL that the event data will be posted to
                    example: http://example.com/webhook
                  description:
                    type: string
                    description: a description of the webhook
                    example: My webhook
                  auth_key:
                    type: string
                    description: the key used to requests for this webhook
                    example: UHeOnTqMBMGqAEMadhA6xQ
                  events:
                    type: array
                    description: The message events that will be posted to the hook
                    items:
                      type: string
                      description: the individual message event
                      enum:
                      - send
                      - hard_bounce
                      - soft_bounce
                      - open
                      - click
                      - spam
                      - unsub
                      - reject
                      example: send
                  created_at:
                    type: string
                    format: date-time
                    description: the date and time that the webhook was created as a UTC string in YYYY-MM-DD HH:MM:SS format
                    example: '2025-04-29 12:00:00'
                  last_sent_at:
                    type: string
                    format: date-time
                    description: the date and time that the webhook last successfully received events as a UTC string in YYYY-MM-DD HH:MM:SS format
                    example: '2025-04-29 14:00:00'
                  batches_sent:
                    type: integer
                    description: the number of event batches that have ever been sent to this webhook
                    example: 12
                  events_sent:
                    type: integer
                    description: the total number of events that have ever been sent to this webhook
                    example: 20
                  last_error:
                    type: string
                    description: if we've ever gotten an error trying to post to this webhook, the last error that we've seen
                    example: Connection timed out
            application/x-php:
              schema:
                type: object
                description: the information about the webhook
                properties:
                  id:
                    type: integer
                    description: a unique integer indentifier for the webhook
                    example: 1131
                  url:
                    type: string
                    description: The URL that the event data will be posted to
                    example: http://example.com/webhook
                  description:
                    type: string
                    description: a description of the webhook
                    example: My webhook
                  auth_key:
                    type: string
                    description: the key used to requests for this webhook
                    example: UHeOnTqMBMGqAEMadhA6xQ
                  events:
                    type: array
                    description: The message events that will be posted to the hook
                    items:
                      type: string
                      description: the individual message event
                      enum:
                      - send
                      - hard_bounce
                      - soft_bounce
                      - open
                      - click
                      - spam
                      - unsub
                      - reject
                      example: send
                  created_at:
                    type: string
                    format: date-time
                    description: the date and time that the webhook was created as a UTC string in YYYY-MM-DD HH:MM:SS format
                    example: '2025-04-29 12:00:00'
                  last_sent_at:
                    type: string
                    format: date-time
                    description: the date and time that the webhook last successfully received events as a UTC string in YYYY-MM-DD HH:MM:SS format
                    example: '2025-04-29 14:00:00'
                  batches_sent:
                    type: integer
                    description: the number of event batches that have ever been sent to this webhook
                    example: 12
                  events_sent:
                    type: integer
                    description: the total number of events that have ever been sent to this webhook
                    example: 20
                  last_error:
                    type: string
                    description: if we've ever gotten an error trying to post to this webhook, the last error that we've seen
                    example: Connection timed out
            application/x-yaml; charset=utf-8:
              schema:
                type: object
                description: the information about the webhook
                properties:
                  id:
                    type: integer
                    description: a unique integer indentifier for the webhook
                    example: 1131
                  url:
                    type: string
                    description: The URL that the event data will be posted to
                    example: http://example.com/webhook
                  description:
                    type: string
                    description: a description of the webhook
                    example: My webhook
                  auth_key:
                    type: string
                    description: the key used to requests for this webhook
                    example: UHeOnTqMBMGqAEMadhA6xQ
                  events:
                    type: array
                    description: The message events that will be posted to the hook
                    items:
                      type: string
                      description: the individual message event
                      enum:
                      - send
                      - hard_bounce
                      - soft_bounce
                      - open
                      - click
                      - spam
                      - unsub
                      - reject
                      example: send
                  created_at:
                    type: string
                    format: date-time
                    description: the date and time that the webhook was created as a UTC string in YYYY-MM-DD HH:MM:SS format
                    example: '2025-04-29 12:00:00'
                  last_sent_at:
                    type: string
                    format: date-time
                    description: the date and time that the webhook last successfully received events as a UTC string in YYYY-MM-DD HH:MM:SS format
                    example: '2025-04-29 14:00:00'
                  batches_sent:
                    type: integer
                    description: the number of event batches that have ever been sent to this webhook
                    example: 12
                  events_sent:
                    type: integer
                    description: the total number of events that have ever been sent to this webhook
                    example: 20
                  last_error:
                    type: string
                    description: if we've ever gotten an error trying to post to this webhook, the last error that we've seen
                    example: Connection timed out
      deprecated: false
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
              - key
              - id
              properties:
                key:
                  type: string
                  description: a valid api key
                id:
                  type: integer
                  description: the unique identifier of a webhook belonging to this account
        required: true
  /webhooks/update:
    post:
      x-custom-config:
        methodNameCamel: update
        methodNameSnake: update
      summary: Update webhook
      description: Update an existing webhook.
      operationId: postWebhooksUpdate
      tags:
      - webhooks
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                description: the information for the updated webhook
                properties:
                  id:
                    type: integer
                    description: a unique integer indentifier for the webhook
                    example: 1131
                  url:
                    type: string
                    description: The URL that the event data will be posted to
                    example: http://example.com/webhook
                  description:
                    type: string
                    description: a description of the webhook
                    example: My webhook
                  auth_key:
                    type: string
                    description: the key used to requests for this webhook
                    example: UHeOnTqMBMGqAEMadhA6xQ
                  events:
                    type: array
                    description: The message events that will be posted to the hook
                    items:
                      type: string
                      description: the individual message event
                      enum:
                      - send
                      - hard_bounce
                      - soft_bounce
                      - open
                      - click
                      - spam
                      - unsub
                      - reject
                      example: send
                  created_at:
                    type: string
                    format: date-time
                    description: the date and time that the webhook was created as a UTC string in YYYY-MM-DD HH:MM:SS format
                    example: '2025-04-29 12:00:00'
                  last_sent_at:
                    type: string
                    format: date-time
                    description: the date and time that the webhook last successfully received events as a UTC string in YYYY-MM-DD HH:MM:SS format
                    example: '2025-04-29 14:00:00'
                  batches_sent:
                    type: integer
                    description: the number of event batches that have ever been sent to this webhook
                    example: 12
                  events_sent:
                    type: integer
                    description: the total number of events that have ever been sent to this webhook
                    example: 100
                  last_error:
                    type: string
                    description: if we've ever gotten an error trying to post to this webhook, the last error that we've seen
                    example: Connection timed out
            application/x-php:
              schema:
                type: object
                description: the information for the updated webhook
                properties:
                  id:
                    type: integer
                    description: a unique integer indentifier for the webhook
                    example: 1131
                  url:
                    type: string
                    description: The URL that the event data will be posted to
                    example: http://example.com/webhook
                  description:
                    type: string
                    description: a description of the webhook
                    example: My webhook
                  auth_key:
                    type: string
                    description: the key used to requests for this webhook
                    example: UHeOnTqMBMGqAEMadhA6xQ
                  events:
                    type: array
                    description: The message events that will be posted to the hook
                    items:
                      type: string
                      description: the individual message event
                      enum:
                      - send
                      - hard_bounce
                      - soft_bounce
                      - open
                      - click
                      - spam
                      - unsub
          

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