Mailchimp Marketing API — Stores. 57 operations. Lead operation: Mailchimp List Stores. Self-contained Naftiko capability covering one Mailchimp business surface.
naftiko: 1.0.0-alpha2
info:
label: Mailchimp Marketing API — Stores
description: 'Mailchimp Marketing API — Stores. 57 operations. Lead operation: Mailchimp List Stores. Self-contained Naftiko
capability covering one Mailchimp business surface.'
tags:
- Mailchimp
- Stores
created: '2026-05-19'
modified: '2026-05-19'
binds:
- namespace: env
keys:
MAILCHIMP_API_KEY: MAILCHIMP_API_KEY
capability:
consumes:
- type: http
namespace: marketing-stores
baseUri: https://server.api.mailchimp.com/3.0
description: Mailchimp Marketing API — Stores business capability. Self-contained, no shared references.
resources:
- name: ecommerce-stores
path: /ecommerce/stores
operations:
- name: getecommercestores
method: GET
description: Mailchimp List Stores
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: fields
in: query
type: array
description: A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
- name: exclude_fields
in: query
type: array
description: A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.
- name: count
in: query
type: integer
description: The number of records to return. Default value is 10. Maximum value is 1000
- name: offset
in: query
type: integer
description: Used for [pagination](https://mailchimp.com/developer/marketing/docs/methods-parameters/#pagination),
this it the number of records from a collection to skip. D
- name: postecommercestores
method: POST
description: Mailchimp Add Store
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: body
in: body
type: object
required: true
- name: ecommerce-stores-store_id
path: /ecommerce/stores/{store_id}
operations:
- name: getecommercestoresid
method: GET
description: Mailchimp Get Store Info
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: fields
in: query
type: array
description: A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
- name: exclude_fields
in: query
type: array
description: A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.
- name: store_id
in: path
type: string
description: The store id.
required: true
- name: patchecommercestoresid
method: PATCH
description: Mailchimp Update Store
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: store_id
in: path
type: string
description: The store id.
required: true
- name: body
in: body
type: object
required: true
- name: deleteecommercestoresid
method: DELETE
description: Mailchimp Delete Store
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: store_id
in: path
type: string
description: The store id.
required: true
- name: ecommerce-stores-store_id-carts
path: /ecommerce/stores/{store_id}/carts
operations:
- name: getecommercestoresidcarts
method: GET
description: Mailchimp List Carts
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: fields
in: query
type: array
description: A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
- name: exclude_fields
in: query
type: array
description: A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.
- name: count
in: query
type: integer
description: The number of records to return. Default value is 10. Maximum value is 1000
- name: offset
in: query
type: integer
description: Used for [pagination](https://mailchimp.com/developer/marketing/docs/methods-parameters/#pagination),
this it the number of records from a collection to skip. D
- name: store_id
in: path
type: string
description: The store id.
required: true
- name: postecommercestoresidcarts
method: POST
description: Mailchimp Add Cart
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: store_id
in: path
type: string
description: The store id.
required: true
- name: body
in: body
type: object
required: true
- name: ecommerce-stores-store_id-carts-cart_id
path: /ecommerce/stores/{store_id}/carts/{cart_id}
operations:
- name: getecommercestoresidcartsid
method: GET
description: Mailchimp Get Cart Info
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: fields
in: query
type: array
description: A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
- name: exclude_fields
in: query
type: array
description: A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.
- name: store_id
in: path
type: string
description: The store id.
required: true
- name: cart_id
in: path
type: string
description: The id for the cart.
required: true
- name: patchecommercestoresidcartsid
method: PATCH
description: Mailchimp Update Cart
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: store_id
in: path
type: string
description: The store id.
required: true
- name: cart_id
in: path
type: string
description: The id for the cart.
required: true
- name: body
in: body
type: object
required: true
- name: deleteecommercestoresidcartsid
method: DELETE
description: Mailchimp Delete Cart
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: store_id
in: path
type: string
description: The store id.
required: true
- name: cart_id
in: path
type: string
description: The id for the cart.
required: true
- name: ecommerce-stores-store_id-carts-cart_id-lines
path: /ecommerce/stores/{store_id}/carts/{cart_id}/lines
operations:
- name: getecommercestoresidcartsidlines
method: GET
description: Mailchimp List Cart Line Items
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: fields
in: query
type: array
description: A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
- name: exclude_fields
in: query
type: array
description: A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.
- name: count
in: query
type: integer
description: The number of records to return. Default value is 10. Maximum value is 1000
- name: offset
in: query
type: integer
description: Used for [pagination](https://mailchimp.com/developer/marketing/docs/methods-parameters/#pagination),
this it the number of records from a collection to skip. D
- name: store_id
in: path
type: string
description: The store id.
required: true
- name: cart_id
in: path
type: string
description: The id for the cart.
required: true
- name: postecommercestoresidcartsidlines
method: POST
description: Mailchimp Add Cart Line Item
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: store_id
in: path
type: string
description: The store id.
required: true
- name: cart_id
in: path
type: string
description: The id for the cart.
required: true
- name: body
in: body
type: object
required: true
- name: ecommerce-stores-store_id-carts-cart_id-lines-line_id
path: /ecommerce/stores/{store_id}/carts/{cart_id}/lines/{line_id}
operations:
- name: getecommercestoresidcartsidlinesid
method: GET
description: Mailchimp Get Cart Line Item
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: fields
in: query
type: array
description: A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
- name: exclude_fields
in: query
type: array
description: A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.
- name: store_id
in: path
type: string
description: The store id.
required: true
- name: cart_id
in: path
type: string
description: The id for the cart.
required: true
- name: line_id
in: path
type: string
description: The id for the line item of a cart.
required: true
- name: patchecommercestoresidcartsidlinesid
method: PATCH
description: Mailchimp Update Cart Line Item
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: store_id
in: path
type: string
description: The store id.
required: true
- name: cart_id
in: path
type: string
description: The id for the cart.
required: true
- name: line_id
in: path
type: string
description: The id for the line item of a cart.
required: true
- name: body
in: body
type: object
required: true
- name: deleteecommercestoresidcartslinesid
method: DELETE
description: Mailchimp Delete Cart Line Item
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: store_id
in: path
type: string
description: The store id.
required: true
- name: cart_id
in: path
type: string
description: The id for the cart.
required: true
- name: line_id
in: path
type: string
description: The id for the line item of a cart.
required: true
- name: ecommerce-stores-store_id-customers
path: /ecommerce/stores/{store_id}/customers
operations:
- name: getecommercestoresidcustomers
method: GET
description: Mailchimp List Customers
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: fields
in: query
type: array
description: A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
- name: exclude_fields
in: query
type: array
description: A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.
- name: count
in: query
type: integer
description: The number of records to return. Default value is 10. Maximum value is 1000
- name: offset
in: query
type: integer
description: Used for [pagination](https://mailchimp.com/developer/marketing/docs/methods-parameters/#pagination),
this it the number of records from a collection to skip. D
- name: store_id
in: path
type: string
description: The store id.
required: true
- name: email_address
in: query
type: string
description: Restrict the response to customers with the email address.
- name: postecommercestoresidcustomers
method: POST
description: Mailchimp Add Customer
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: store_id
in: path
type: string
description: The store id.
required: true
- name: body
in: body
type: object
required: true
- name: ecommerce-stores-store_id-customers-customer_id
path: /ecommerce/stores/{store_id}/customers/{customer_id}
operations:
- name: getecommercestoresidcustomersid
method: GET
description: Mailchimp Get Customer Info
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: fields
in: query
type: array
description: A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
- name: exclude_fields
in: query
type: array
description: A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.
- name: store_id
in: path
type: string
description: The store id.
required: true
- name: customer_id
in: path
type: string
description: The id for the customer of a store.
required: true
- name: putecommercestoresidcustomersid
method: PUT
description: Mailchimp Add or Update Customer
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: store_id
in: path
type: string
description: The store id.
required: true
- name: customer_id
in: path
type: string
description: The id for the customer of a store.
required: true
- name: body
in: body
type: object
required: true
- name: patchecommercestoresidcustomersid
method: PATCH
description: Mailchimp Update Customer
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: store_id
in: path
type: string
description: The store id.
required: true
- name: customer_id
in: path
type: string
description: The id for the customer of a store.
required: true
- name: body
in: body
type: object
required: true
- name: deleteecommercestoresidcustomersid
method: DELETE
description: Mailchimp Delete Customer
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: store_id
in: path
type: string
description: The store id.
required: true
- name: customer_id
in: path
type: string
description: The id for the customer of a store.
required: true
- name: ecommerce-stores-store_id-orders
path: /ecommerce/stores/{store_id}/orders
operations:
- name: getecommercestoresidorders
method: GET
description: Mailchimp List Orders
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: fields
in: query
type: array
description: A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
- name: exclude_fields
in: query
type: array
description: A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.
- name: count
in: query
type: integer
description: The number of records to return. Default value is 10. Maximum value is 1000
- name: offset
in: query
type: integer
description: Used for [pagination](https://mailchimp.com/developer/marketing/docs/methods-parameters/#pagination),
this it the number of records from a collection to skip. D
- name: store_id
in: path
type: string
description: The store id.
required: true
- name: customer_id
in: query
type: string
description: Restrict results to orders made by a specific customer.
- name: has_outreach
in: query
type: boolean
description: Restrict results to orders that have an outreach attached. For example, an email campaign or Facebook
ad.
- name: campaign_id
in: query
type: string
description: Restrict results to orders with a specific `campaign_id` value.
- name: outreach_id
in: query
type: string
description: Restrict results to orders with a specific `outreach_id` value.
- name: postecommercestoresidorders
method: POST
description: Mailchimp Add Order
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: store_id
in: path
type: string
description: The store id.
required: true
- name: body
in: body
type: object
required: true
- name: ecommerce-stores-store_id-orders-order_id
path: /ecommerce/stores/{store_id}/orders/{order_id}
operations:
- name: getecommercestoresidordersid
method: GET
description: Mailchimp Get Order Info
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: fields
in: query
type: array
description: A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
- name: exclude_fields
in: query
type: array
description: A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.
- name: store_id
in: path
type: string
description: The store id.
required: true
- name: order_id
in: path
type: string
description: The id for the order in a store.
required: true
- name: patchecommercestoresidordersid
method: PATCH
description: Mailchimp Update Order
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: store_id
in: path
type: string
description: The store id.
required: true
- name: order_id
in: path
type: string
description: The id for the order in a store.
required: true
- name: body
in: body
type: object
required: true
- name: deleteecommercestoresidordersid
method: DELETE
description: Mailchimp Delete Order
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: store_id
in: path
type: string
description: The store id.
required: true
- name: order_id
in: path
type: string
description: The id for the order in a store.
required: true
- name: ecommerce-stores-store_id-orders-order_id-lines
path: /ecommerce/stores/{store_id}/orders/{order_id}/lines
operations:
- name: getecommercestoresidordersidlines
method: GET
description: Mailchimp List Order Line Items
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: fields
in: query
type: array
description: A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
- name: exclude_fields
in: query
type: array
description: A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.
- name: count
in: query
type: integer
description: The number of records to return. Default value is 10. Maximum value is 1000
- name: offset
in: query
type: integer
description: Used for [pagination](https://mailchimp.com/developer/marketing/docs/methods-parameters/#pagination),
this it the number of records from a collection to skip. D
- name: store_id
in: path
type: string
description: The store id.
required: true
- name: order_id
in: path
type: string
description: The id for the order in a store.
required: true
- name: postecommercestoresidordersidlines
method: POST
description: Mailchimp Add Order Line Item
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: store_id
in: path
type: string
description: The store id.
required: true
- name: order_id
in: path
type: string
description: The id for the order in a store.
required: true
- name: body
in: body
type: object
required: true
- name: ecommerce-stores-store_id-orders-order_id-lines-line_id
path: /ecommerce/stores/{store_id}/orders/{order_id}/lines/{line_id}
operations:
- name: getecommercestoresidordersidlinesid
method: GET
description: Mailchimp Get Order Line Item
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: fields
in: query
type: array
description: A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
- name: exclude_fields
in: query
type: array
description: A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.
- name: store_id
in: path
type: string
description: The store id.
required: true
- name: order_id
in: path
type: string
description: The id for the order in a store.
required: true
- name: line_id
in: path
type: string
description: The id for the line item of an order.
required: true
- name: patchecommercestoresidordersidlinesid
method: PATCH
description: Mailchimp Update Order Line Item
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: store_id
in: path
type: string
description: The store id.
required: true
- name: order_id
in: path
type: string
description: The id for the order in a store.
required: true
- name: line_id
in: path
type: string
description: The id for the line item of an order.
required: true
- name: body
in: body
type: object
required: true
- name: deleteecommercestoresidordersidlinesid
method: DELETE
description: Mailchimp Delete Order Line Item
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: store_id
in: path
type: string
description: The store id.
required: true
- name: order_id
in: path
type: string
description: The id for the order in a store.
required: true
- name: line_id
in: path
type: string
description: The id for the line item of an order.
required: true
- name: ecommerce-stores-store_id-products
path: /ecommerce/stores/{store_id}/products
operations:
- name: getecommercestoresidproducts
method: GET
description: Mailchimp List Product
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: fields
in: query
type: array
description: A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
- name: exclude_fields
in: query
type: array
description: A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.
- name: count
in: query
type: integer
description: The number of records to return. Default value is 10. Maximum value is 1000
- name: offset
in: query
type: integer
description: Used for [pagination](https://mailchimp.com/developer/marketing/docs/methods-parameters/#pagination),
this it the number of records from a collection to skip. D
- name: store_id
in: path
type: string
description: The store id.
required: true
- name: postecommercestoresidproducts
method: POST
description: Mailchimp Add Product
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: store_id
in: path
type: string
description: The store id.
required: true
- name: body
in: body
type: object
required: true
- name: ecommerce-stores-store_id-products-product_id
path: /ecommerce/stores/{store_id}/products/{product_id}
operations:
- name: getecommercestoresidproductsid
method: GET
description: Mailchimp Get Product Info
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: fields
in: query
type: array
description: A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
- name: exclude_fields
in: query
type: array
description: A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.
- name: store_id
in: path
type: string
description: The store id.
required: true
- name: product_id
in: path
type: string
description: The id for the product of a store.
required: true
- name: patchecommercestoresidproductsid
method: PATCH
description: Mailchimp Update Product
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: store_id
in: path
type: string
description: The store id.
required: true
- name: product_id
in: path
type: string
description: The id for the product of a store.
required: true
- name: body
in: body
type: object
required: true
- name: deleteecommercestoresidproductsid
method: DELETE
description: Mailchimp Delete Product
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: store_id
in: path
type: string
description: The store id.
required: true
- name: product_id
in: path
type: string
description: The id for the product of a store.
required: true
- name: ecommerce-stores-store_id-products-product_id-images
path: /ecommerce/stores/{store_id}/products/{product_id}/images
operations:
- name: getecommercestoresidproductsidimages
method: GET
description: Mailchimp List Product Images
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: fields
in: query
type: array
description: A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
- name: exclude_fields
in: query
type: array
description: A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.
- name: count
in: query
type: integer
description: The number of records to return. Default value is 10. Maximum value is 1000
- name: offset
in: query
type: integer
description: Used for [pagination](https://mailchimp.com/developer/marketing/docs/methods-parameters/#pagination),
this it the number of records from a collection to skip. D
- name: store_id
in: path
type: string
description: The store id.
required: true
- name: product_id
in: path
type: string
description: The id for the product of a store.
required: true
- name: postecommercestoresidproductsidimages
method: POST
description: Mailchimp Add Product Image
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: store_id
in: path
type: string
# --- truncated at 32 KB (100 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/mailchimp/refs/heads/main/capabilities/marketing-stores.yaml