Mailchimp · Authentication Profile

Mailchimp Authentication

Authentication

Mailchimp secures its APIs with apiKey, http, and oauth2 across 3 declared security schemes, as derived from its OpenAPI definitions. OAuth 2.0 is offered via the authorizationCode flow(s).

CampaignsEmail MarketingMarketing AutomationNewslettersTransactional EmailAudience ManagementSMSE-CommerceWebhookMarketing Analytics
Methods: apiKey, http, oauth2 Schemes: 3 OAuth flows: authorizationCode API key in: header, body

Security Schemes

basicAuth http
scheme: basic
oauth2 oauth2
apiKey apiKey
· in: header (X-MC-ApiKey)

Source

Authentication Profile

Raw ↑
generated: '2026-06-20'
method: searched
source: >-
  openapi/mailchimp-marketing-api-openapi.yml,
  openapi/mailchimp-transactional-api-openapi.yml, enriched from
  https://mailchimp.com/developer/marketing/guides/access-user-data-oauth-2/ and
  https://mailchimp.com/developer/transactional/docs/authentication-delivery/
docs:
  - https://mailchimp.com/developer/marketing/guides/access-user-data-oauth-2/
  - https://mailchimp.com/developer/transactional/docs/authentication-delivery/
summary:
  types:
  - apiKey
  - http
  - oauth2
  api_key_in:
  - header
  - body
  oauth2_flows:
  - authorizationCode
schemes:
- name: basicAuth
  type: http
  scheme: basic
  api: mailchimp:mailchimp-marketing-api
  description: >-
    Marketing API HTTP Basic auth. Use any string as the username and the API
    key as the password. The API key carries a datacenter suffix (e.g. -us19)
    which also determines the request host <dc>.api.mailchimp.com.
  sources:
  - openapi/mailchimp-marketing-api-openapi.yml
- name: oauth2
  type: oauth2
  api: mailchimp:mailchimp-marketing-api
  flow: authorizationCode
  authorizationUrl: https://login.mailchimp.com/oauth2/authorize
  tokenUrl: https://login.mailchimp.com/oauth2/token
  metadataUrl: https://login.mailchimp.com/oauth2/metadata
  scopes: []
  description: >-
    OAuth 2.0 authorization-code flow for accessing a user's Mailchimp data
    (used by apps/integrations). Mailchimp OAuth grants full account access and
    does NOT use granular scopes. After the token exchange, call the metadata
    endpoint to discover the account's datacenter (dc) for API requests. Not
    declared in the OpenAPI securityDefinitions; documented only.
  sources:
  - https://mailchimp.com/developer/marketing/guides/access-user-data-oauth-2/
- name: apiKey
  type: apiKey
  in: header
  parameter: X-MC-ApiKey
  api: mailchimp:mailchimp-transactional-api
  description: >-
    Transactional (Mandrill) API key authentication. The key is passed in the
    JSON request body as the "key" parameter for every POST call, or
    alternatively via the X-MC-ApiKey header. A "test" API key exercises the
    API in test mode without delivering mail (see sandbox/mailchimp-sandbox.yml).
  sources:
  - openapi/mailchimp-transactional-api-openapi.yml