Mailchimp Landing Pages API

The landingPages API from Mailchimp — 5 operation(s) for landingpages.

Operations 8

GET /landing-pages List landing pages #
POST /landing-pages Add landing page #
GET /landing-pages/{page_id} Get landing page info #
PATCH /landing-pages/{page_id} Update landing page #
DELETE /landing-pages/{page_id} Delete landing page #
POST /landing-pages/{page_id}/actions/publish Publish landing page #
POST /landing-pages/{page_id}/actions/unpublish Unpublish landing page #
GET /landing-pages/{page_id}/content Get landing page content #

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-landingpages-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.

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

OpenAPI Specification

mailchimp-landingpages-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  version: 3.0.91
  title: Mailchimp Marketing Landing Pages API
  contact:
    name: Mailchimp API Support
    email: apihelp@mailchimp.com
  x-permalink: https://github.com/mailchimp/mailchimp-client-lib-codegen/blob/main/spec/marketing.json
servers:
- url: https://server.api.mailchimp.com/3.0
security:
- basicAuth: []
tags:
- name: landingPages
paths:
  /landing-pages:
    get:
      description: Get all landing pages.
      operationId: getAllLandingPages
      parameters:
      - name: sort_dir
        x-title: Sort Direction
        description: Determines the order direction for sorted results.
        in: query
        required: false
        schema:
          type: string
          enum:
          - ASC
          - DESC
      - name: sort_field
        x-title: Sort By Field
        description: Returns files sorted by the specified field.
        in: query
        required: false
        schema:
          type: string
          enum:
          - created_at
          - updated_at
      - name: fields
        x-title: Fields
        in: query
        description: A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
        required: false
        style: form
        explode: false
        schema:
          type: array
          items:
            type: string
      - name: exclude_fields
        x-title: Exclude Fields
        in: query
        description: A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.
        required: false
        style: form
        explode: false
        schema:
          type: array
          items:
            type: string
      - name: count
        x-title: Count
        in: query
        description: The number of records to return. Default value is 10. Maximum value is 1000
        required: false
        schema:
          type: integer
          default: 10
          maximum: 1000
      responses:
        '200':
          description: Landing Pages Collection
          content:
            application/json:
              schema:
                type: object
                description: A collection of landing pages.
                properties:
                  landing_pages:
                    type: array
                    description: The landing pages on the account
                    items:
                      type: object
                      title: Landing Page
                      description: A summary of an individual landing page's settings and content.
                      properties:
                        id:
                          type: string
                          title: Landing Page ID
                          description: A string that uniquely identifies this landing page.
                          readOnly: true
                          example: 030092c2e1f0
                        name:
                          type: string
                          title: Landing Page Name
                          description: The name of this landing page.
                          readOnly: false
                        title:
                          type: string
                          title: Landing Page title
                          description: The title of this landing page seen in the browser's title bar.
                          readOnly: false
                        description:
                          type: string
                          title: Landing Page description
                          description: The description of this landing page.
                          readOnly: false
                        template_id:
                          type: integer
                          title: Landing Page template_id
                          description: The template_id of this landing page.
                          readOnly: true
                        status:
                          type: string
                          title: Landing Page status
                          description: The status of this landing page.
                          enum:
                          - published
                          - unpublished
                          - draft
                          readOnly: true
                        list_id:
                          type: string
                          title: Landing Page list id
                          description: The list's ID associated with this landing page.
                          example: fde02ad86b
                          readOnly: false
                        store_id:
                          type: string
                          title: Store ID
                          description: The ID of the store associated with this landing page.
                          readOnly: false
                        web_id:
                          type: integer
                          title: Landing Page Web ID
                          description: The ID used in the Mailchimp web application.
                        created_by_source:
                          type: string
                          title: Created By Source
                          description: Created by mobile or web
                          readOnly: true
                        url:
                          type: string
                          title: Published url
                          description: The url of the published landing page.
                          readOnly: true
                        created_at:
                          type: string
                          title: Created At
                          description: The time this landing page was created.
                          format: date-time
                          readOnly: true
                        published_at:
                          type: string
                          title: Published at
                          description: The time this landing page was published.
                          format: date-time
                          readOnly: true
                        unpublished_at:
                          type: string
                          title: Unpublished at
                          description: The time this landing page was unpublished.
                          format: date-time
                          readOnly: true
                        updated_at:
                          type: string
                          title: Updated_at
                          description: The time this landing page was updated at.
                          format: date-time
                          readOnly: true
                        tracking:
                          type: object
                          title: Tracking Settings
                          description: The tracking settings applied to this landing page.
                          properties:
                            track_with_mailchimp:
                              type: boolean
                              title: Track with Mailchimp
                              description: Use cookies to track unique visitors and calculate overall conversion rate. Learn more [here](https://mailchimp.com/help/use-track-mailchimp/).
                            enable_restricted_data_processing:
                              type: boolean
                              title: Enable restricted data processing
                              description: Google offers restricted data processing in connection with the California Consumer Privacy Act (CCPA) to restrict how Google uses certain identifiers and other data processed in the provision of its services. You can learn more about Google's restricted data processing within Google Ads [here](https://privacy.google.com/businesses/rdp/).
                        _links:
                          title: Links
                          description: A list of link types and descriptions for the API schema documents.
                          type: array
                          items:
                            type: object
                            title: Resource Link
                            description: This object represents a link from the resource where it is found to another resource or action that may be performed.
                            properties:
                              rel:
                                type: string
                                title: Rel
                                description: As with an HTML 'rel' attribute, this describes the type of link.
                                readOnly: true
                              href:
                                type: string
                                title: Href
                                description: This property contains a fully-qualified URL that can be called to retrieve the linked resource or perform the linked action.
                                readOnly: true
                              method:
                                type: string
                                title: Method
                                description: The HTTP method that should be used when accessing the URL defined in 'href'.
                                enum:
                                - GET
                                - POST
                                - PUT
                                - PATCH
                                - DELETE
                                - OPTIONS
                                - HEAD
                                readOnly: true
                              targetSchema:
                                type: string
                                title: Target Schema
                                description: For GETs, this is a URL representing the schema that the response should conform to.
                                readOnly: true
                              schema:
                                type: string
                                title: Schema
                                description: For HTTP methods that can receive bodies (POST and PUT), this is a URL representing the schema that the body should conform to.
                                readOnly: true
                          readOnly: true
                  total_items:
                    type: integer
                    title: Item Count
                    description: The total number of items matching the query regardless of pagination.
                    readOnly: true
                  _links:
                    title: Links
                    description: A list of link types and descriptions for the API schema documents.
                    type: array
                    items:
                      type: object
                      title: Resource Link
                      description: This object represents a link from the resource where it is found to another resource or action that may be performed.
                      properties:
                        rel:
                          type: string
                          title: Rel
                          description: As with an HTML 'rel' attribute, this describes the type of link.
                          readOnly: true
                        href:
                          type: string
                          title: Href
                          description: This property contains a fully-qualified URL that can be called to retrieve the linked resource or perform the linked action.
                          readOnly: true
                        method:
                          type: string
                          title: Method
                          description: The HTTP method that should be used when accessing the URL defined in 'href'.
                          enum:
                          - GET
                          - POST
                          - PUT
                          - PATCH
                          - DELETE
                          - OPTIONS
                          - HEAD
                          readOnly: true
                        targetSchema:
                          type: string
                          title: Target Schema
                          description: For GETs, this is a URL representing the schema that the response should conform to.
                          readOnly: true
                        schema:
                          type: string
                          title: Schema
                          description: For HTTP methods that can receive bodies (POST and PUT), this is a URL representing the schema that the body should conform to.
                          readOnly: true
                    readOnly: true
            application/problem+json:
              schema:
                type: object
                description: A collection of landing pages.
                properties:
                  landing_pages:
                    type: array
                    description: The landing pages on the account
                    items:
                      type: object
                      title: Landing Page
                      description: A summary of an individual landing page's settings and content.
                      properties:
                        id:
                          type: string
                          title: Landing Page ID
                          description: A string that uniquely identifies this landing page.
                          readOnly: true
                          example: 030092c2e1f0
                        name:
                          type: string
                          title: Landing Page Name
                          description: The name of this landing page.
                          readOnly: false
                        title:
                          type: string
                          title: Landing Page title
                          description: The title of this landing page seen in the browser's title bar.
                          readOnly: false
                        description:
                          type: string
                          title: Landing Page description
                          description: The description of this landing page.
                          readOnly: false
                        template_id:
                          type: integer
                          title: Landing Page template_id
                          description: The template_id of this landing page.
                          readOnly: true
                        status:
                          type: string
                          title: Landing Page status
                          description: The status of this landing page.
                          enum:
                          - published
                          - unpublished
                          - draft
                          readOnly: true
                        list_id:
                          type: string
                          title: Landing Page list id
                          description: The list's ID associated with this landing page.
                          example: fde02ad86b
                          readOnly: false
                        store_id:
                          type: string
                          title: Store ID
                          description: The ID of the store associated with this landing page.
                          readOnly: false
                        web_id:
                          type: integer
                          title: Landing Page Web ID
                          description: The ID used in the Mailchimp web application.
                        created_by_source:
                          type: string
                          title: Created By Source
                          description: Created by mobile or web
                          readOnly: true
                        url:
                          type: string
                          title: Published url
                          description: The url of the published landing page.
                          readOnly: true
                        created_at:
                          type: string
                          title: Created At
                          description: The time this landing page was created.
                          format: date-time
                          readOnly: true
                        published_at:
                          type: string
                          title: Published at
                          description: The time this landing page was published.
                          format: date-time
                          readOnly: true
                        unpublished_at:
                          type: string
                          title: Unpublished at
                          description: The time this landing page was unpublished.
                          format: date-time
                          readOnly: true
                        updated_at:
                          type: string
                          title: Updated_at
                          description: The time this landing page was updated at.
                          format: date-time
                          readOnly: true
                        tracking:
                          type: object
                          title: Tracking Settings
                          description: The tracking settings applied to this landing page.
                          properties:
                            track_with_mailchimp:
                              type: boolean
                              title: Track with Mailchimp
                              description: Use cookies to track unique visitors and calculate overall conversion rate. Learn more [here](https://mailchimp.com/help/use-track-mailchimp/).
                            enable_restricted_data_processing:
                              type: boolean
                              title: Enable restricted data processing
                              description: Google offers restricted data processing in connection with the California Consumer Privacy Act (CCPA) to restrict how Google uses certain identifiers and other data processed in the provision of its services. You can learn more about Google's restricted data processing within Google Ads [here](https://privacy.google.com/businesses/rdp/).
                        _links:
                          title: Links
                          description: A list of link types and descriptions for the API schema documents.
                          type: array
                          items:
                            type: object
                            title: Resource Link
                            description: This object represents a link from the resource where it is found to another resource or action that may be performed.
                            properties:
                              rel:
                                type: string
                                title: Rel
                                description: As with an HTML 'rel' attribute, this describes the type of link.
                                readOnly: true
                              href:
                                type: string
                                title: Href
                                description: This property contains a fully-qualified URL that can be called to retrieve the linked resource or perform the linked action.
                                readOnly: true
                              method:
                                type: string
                                title: Method
                                description: The HTTP method that should be used when accessing the URL defined in 'href'.
                                enum:
                                - GET
                                - POST
                                - PUT
                                - PATCH
                                - DELETE
                                - OPTIONS
                                - HEAD
                                readOnly: true
                              targetSchema:
                                type: string
                                title: Target Schema
                                description: For GETs, this is a URL representing the schema that the response should conform to.
                                readOnly: true
                              schema:
                                type: string
                                title: Schema
                                description: For HTTP methods that can receive bodies (POST and PUT), this is a URL representing the schema that the body should conform to.
                                readOnly: true
                          readOnly: true
                  total_items:
                    type: integer
                    title: Item Count
                    description: The total number of items matching the query regardless of pagination.
                    readOnly: true
                  _links:
                    title: Links
                    description: A list of link types and descriptions for the API schema documents.
                    type: array
                    items:
                      type: object
                      title: Resource Link
                      description: This object represents a link from the resource where it is found to another resource or action that may be performed.
                      properties:
                        rel:
                          type: string
                          title: Rel
                          description: As with an HTML 'rel' attribute, this describes the type of link.
                          readOnly: true
                        href:
                          type: string
                          title: Href
                          description: This property contains a fully-qualified URL that can be called to retrieve the linked resource or perform the linked action.
                          readOnly: true
                        method:
                          type: string
                          title: Method
                          description: The HTTP method that should be used when accessing the URL defined in 'href'.
                          enum:
                          - GET
                          - POST
                          - PUT
                          - PATCH
                          - DELETE
                          - OPTIONS
                          - HEAD
                          readOnly: true
                        targetSchema:
                          type: string
                          title: Target Schema
                          description: For GETs, this is a URL representing the schema that the response should conform to.
                          readOnly: true
                        schema:
                          type: string
                          title: Schema
                          description: For HTTP methods that can receive bodies (POST and PUT), this is a URL representing the schema that the body should conform to.
                          readOnly: true
                    readOnly: true
        default:
          description: An error generated by the Mailchimp API.
          content:
            application/json:
              schema:
                type: object
                title: Problem Detail Document
                description: An error generated by the Mailchimp API. Conforms to IETF draft 'draft-nottingham-http-problem-06'.
                required:
                - type
                - title
                - status
                - detail
                - instance
                properties:
                  type:
                    type: string
                    title: Problem Type
                    description: An absolute URI that identifies the problem type. When dereferenced, it should provide human-readable documentation for the problem type.
                    example: https://mailchimp.com/developer/marketing/docs/errors/
                  title:
                    type: string
                    title: Error Title
                    description: A short, human-readable summary of the problem type. It shouldn't change based on the occurrence of the problem, except for purposes of localization.
                    example: Resource Not Found
                  status:
                    type: integer
                    title: HTTP Status Code
                    description: The HTTP status code (RFC2616, Section 6) generated by the origin server for this occurrence of the problem.
                    example: 404
                  detail:
                    type: string
                    title: Error Message
                    description: A human-readable explanation specific to this occurrence of the problem. [Learn more about errors](/developer/guides/get-started-with-mailchimp-api-3/#Errors).
                    example: The requested resource could not be found.
                  instance:
                    type: string
                    title: Instance ID
                    description: A string that identifies this specific occurrence of the problem. Please provide this ID when contacting support.
                    example: 995c5cb0-3280-4a6e-808b-3b096d0bb219
            application/problem+json:
              schema:
                type: object
                title: Problem Detail Document
                description: An error generated by the Mailchimp API. Conforms to IETF draft 'draft-nottingham-http-problem-06'.
                required:
                - type
                - title
                - status
                - detail
                - instance
                properties:
                  type:
                    type: string
                    title: Problem Type
                    description: An absolute URI that identifies the problem type. When dereferenced, it should provide human-readable documentation for the problem type.
                    example: https://mailchimp.com/developer/marketing/docs/errors/
                  title:
                    type: string
                    title: Error Title
                    description: A short, human-readable summary of the problem type. It shouldn't change based on the occurrence of the problem, except for purposes of localization.
                    example: Resource Not Found
                  status:
                    type: integer
                    title: HTTP Status Code
                    description: The HTTP status code (RFC2616, Section 6) generated by the origin server for this occurrence of the problem.
                    example: 404
                  detail:
                    type: string
                    title: Error Message
                    description: A human-readable explanation specific to this occurrence of the problem. [Learn more about errors](/developer/guides/get-started-with-mailchimp-api-3/#Errors).
                    example: The requested resource could not be found.
                  instance:
                    type: string
                    title: Instance ID
                    description: A string that identifies this specific occurrence of the problem. Please provide this ID when contacting support.
                    example: 995c5cb0-3280-4a6e-808b-3b096d0bb219
      tags:
      - landingPages
      x-custom-config:
        methodNameSnake: get_all
        methodNameCamel: getAll
      summary: List landing pages
    post:
      summary: Add landing page
      description: Create an unpublished and contentless Mailchimp landing page.
      parameters:
      - in: query
        name: use_default_list
        x-title: Use Default List
        required: false
        description: Will create the Landing Page using the account's Default List instead of requiring a list_id.
        schema:
          type: boolean
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                title: Landing Page
                description: A summary of an individual landing page's settings and content.
                properties:
                  id:
                    type: string
                    title: Landing Page ID
                    description: A string that uniquely identifies this landing page.
                    readOnly: true
                    example: 030092c2e1f0
                  name:
                    type: string
                    title: Landing Page Name
                    description: The name of this landing page.
                    readOnly: false
                  title:
                    type: string
                    title: Landing Page title
                    description: The title of this landing page seen in the browser's title bar.
                    readOnly: false
                  description:
                    type: string
                    title: Landing Page description
                    description: The description of this landing page.
                    readOnly: false
                  template_id:
                    type: integer
                    title: Landing Page template_id
                    description: The template_id of this landing page.
                    readOnly: true
                  status:
                    type: string
                    title: Landing Page status
                    description: The status of this landing page.
                    enum:
                    - published
                    - unpublished
                    - draft
                    readOnly: true
                  list_id:
                    type: string
                    title: Landing Page list id
                    description: The list's ID associated with this landing page.
                    example: fde02ad86b
                    readOnly: false
                  store_id:
                    type: string
                    title: Store ID
                    description: The ID of the store associated with this landing page.
                    readOnly: false
                  web_id:
                    type: integer
                    title: Landing Page Web ID
                    description: The ID used in the Mailchimp web application.
                  created_by_source:
                    type: string
                    title: Created By Source
                    description: Created by mobile or web
                    readOnly: true
                  url:
                    type: string
                    title: Published url
                    description: The url of the published landing page.
                    readOnly: true
                  created_at:
                    type: string
                    title: Created At
                    description: The time this landing page was created.
                    format: date-time
                    readOnly: true
                  published_at:
                    type: string
                    title: Published at
                    description: The time this landing page was published.
                    format: date-time
                    readOnly: true
                  unpublished_at:
                    type: string
                    title: Unpublished at
                    description: The time this landing page was unpublished.
                    format: date-time
                    readOnly: true
                  updated_at:
                    type: string
                    title: Updated_at
                    description: The time this landing page was updated at.
                    format: date-time
                    readOnly: true
                  tracking:
                    type: object
                    title: Tracking Settings
                    description: The tracking settings applied to this landing page.
                    properties:
                      track_with_mailchimp:
                        type: boolean
                        title: Track with Mailchimp
                        description: Use cookies to track unique visitors and calculate overall conversion rate. Learn more [here](https://mailchimp.com/help/use-track-mailchimp/).
                      ena

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