Mailchimp Marketing API — Members

naftiko: 1.0.0-alpha2
info:
  label: Mailchimp Marketing API  — Members
  description: 'Mailchimp Marketing API  — Members. 25 operations. Lead operation: Mailchimp List Members Info. Self-contained
    Naftiko capability covering one Mailchimp business surface.'
  tags:
  - Mailchimp
  - Members
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    MAILCHIMP_API_KEY: MAILCHIMP_API_KEY
capability:
  consumes:
  - type: http
    namespace: marketing-members
    baseUri: https://server.api.mailchimp.com/3.0
    description: Mailchimp Marketing API  — Members business capability. Self-contained, no shared references.
    resources:
    - name: lists-list_id-members
      path: /lists/{list_id}/members
      operations:
      - name: getlistsidmembers
        method: GET
        description: Mailchimp List Members 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: 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: list_id
          in: path
          type: string
          description: The unique ID for the list.
          required: true
        - name: email_type
          in: query
          type: string
          description: The email type.
        - name: status
          in: query
          type: string
          description: The subscriber's status.
        - name: since_timestamp_opt
          in: query
          type: string
          description: 'Restrict results to subscribers who opted-in after the set timeframe. Uses ISO 8601 time format: 2015-10-21T15:41:36+00:00.'
        - name: before_timestamp_opt
          in: query
          type: string
          description: 'Restrict results to subscribers who opted-in before the set timeframe. Uses ISO 8601 time format:
            2015-10-21T15:41:36+00:00.'
        - name: since_last_changed
          in: query
          type: string
          description: 'Restrict results to subscribers whose information changed after the set timeframe. Uses ISO 8601 time
            format: 2015-10-21T15:41:36+00:00.'
        - name: before_last_changed
          in: query
          type: string
          description: 'Restrict results to subscribers whose information changed before the set timeframe. Uses ISO 8601
            time format: 2015-10-21T15:41:36+00:00.'
        - name: unique_email_id
          in: query
          type: string
          description: A unique identifier for the email address across all Mailchimp lists.
        - name: vip_only
          in: query
          type: boolean
          description: A filter to return only the list's VIP members. Passing `true` will restrict results to VIP list members,
            passing `false` will return all list members.
        - name: interest_category_id
          in: query
          type: string
          description: The unique id for the interest category.
        - name: interest_ids
          in: query
          type: string
          description: Used to filter list members by interests. Must be accompanied by interest_category_id and interest_match.
            The value must be a comma separated list of interest i
        - name: interest_match
          in: query
          type: string
          description: Used to filter list members by interests. Must be accompanied by interest_category_id and interest_ids.
            "any" will match a member with any of the interest suppl
        - name: sort_field
          in: query
          type: string
          description: Returns files sorted by the specified field.
        - name: sort_dir
          in: query
          type: string
          description: Determines the order direction for sorted results.
        - name: since_last_campaign
          in: query
          type: boolean
          description: Filter subscribers by those subscribed/unsubscribed/pending/cleaned since last email campaign send.
            Member status is required to use this filter.
        - name: unsubscribed_since
          in: query
          type: string
          description: Filter subscribers by those unsubscribed since a specific date. Using any status other than unsubscribed
            with this filter will result in an error.
      - name: postlistsidmembers
        method: POST
        description: Mailchimp Add Member to List
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: list_id
          in: path
          type: string
          description: The unique ID for the list.
          required: true
        - name: skip_merge_validation
          in: query
          type: boolean
          description: If skip_merge_validation is true, member data will be accepted without merge field values, even if
            the merge field is usually required. This defaults to false.
        - name: body
          in: body
          type: object
          required: true
    - name: lists-list_id-members-subscriber_hash
      path: /lists/{list_id}/members/{subscriber_hash}
      operations:
      - name: getlistsidmembersid
        method: GET
        description: Mailchimp Get Member 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: list_id
          in: path
          type: string
          description: The unique ID for the list.
          required: true
        - name: subscriber_hash
          in: path
          type: string
          description: The MD5 hash of the lowercase version of the list member's email address. This endpoint also accepts
            a list member's email address or contact_id.
          required: true
      - name: putlistsidmembersid
        method: PUT
        description: Mailchimp Add or Update List Member
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: list_id
          in: path
          type: string
          description: The unique ID for the list.
          required: true
        - name: subscriber_hash
          in: path
          type: string
          description: The MD5 hash of the lowercase version of the list member's email address. This endpoint also accepts
            a list member's email address or contact_id.
          required: true
        - name: skip_merge_validation
          in: query
          type: boolean
          description: If skip_merge_validation is true, member data will be accepted without merge field values, even if
            the merge field is usually required. This defaults to false.
        - name: body
          in: body
          type: object
          required: true
      - name: patchlistsidmembersid
        method: PATCH
        description: Mailchimp Update List Member
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: list_id
          in: path
          type: string
          description: The unique ID for the list.
          required: true
        - name: subscriber_hash
          in: path
          type: string
          description: The MD5 hash of the lowercase version of the list member's email address. This endpoint also accepts
            a list member's email address or contact_id.
          required: true
        - name: skip_merge_validation
          in: query
          type: boolean
          description: If skip_merge_validation is true, member data will be accepted without merge field values, even if
            the merge field is usually required. This defaults to false.
        - name: body
          in: body
          type: object
          required: true
      - name: deletelistsidmembersid
        method: DELETE
        description: Mailchimp Archive List Member
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: list_id
          in: path
          type: string
          description: The unique ID for the list.
          required: true
        - name: subscriber_hash
          in: path
          type: string
          description: The MD5 hash of the lowercase version of the list member's email address. This endpoint also accepts
            a list member's email address or contact_id.
          required: true
    - name: lists-list_id-members-subscriber_hash-actions-delete-permanent
      path: /lists/{list_id}/members/{subscriber_hash}/actions/delete-permanent
      operations:
      - name: postlistsidmembershashactionsdeletepermanent
        method: POST
        description: Mailchimp Delete List Member
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: list_id
          in: path
          type: string
          description: The unique ID for the list.
          required: true
        - name: subscriber_hash
          in: path
          type: string
          description: The MD5 hash of the lowercase version of the list member's email address.
          required: true
    - name: lists-list_id-members-subscriber_hash-activity
      path: /lists/{list_id}/members/{subscriber_hash}/activity
      operations:
      - name: getlistsidmembersidactivity
        method: GET
        description: Mailchimp View Recent Activity 50
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: list_id
          in: path
          type: string
          description: The unique ID for the list.
          required: true
        - name: subscriber_hash
          in: path
          type: string
          description: The MD5 hash of the lowercase version of the list member's email address. This endpoint also accepts
            a list member's email address or contact_id.
          required: true
        - 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: action
          in: query
          type: array
          description: A comma seperated list of actions to return.
    - name: lists-list_id-members-subscriber_hash-activity-feed
      path: /lists/{list_id}/members/{subscriber_hash}/activity-feed
      operations:
      - name: getlistsidmembersidactivityfeed
        method: GET
        description: Mailchimp View Recent Activity
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: list_id
          in: path
          type: string
          description: The unique ID for the list.
          required: true
        - name: subscriber_hash
          in: path
          type: string
          description: The MD5 hash of the lowercase version of the list member's email address. This endpoint also accepts
            a list member's email address or contact_id.
          required: true
        - 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: activity_filters
          in: query
          type: array
          description: A comma-separated list of activity filters that correspond to a set of activity types, e.g "?activity_filters=open,bounce,click".
    - name: lists-list_id-members-subscriber_hash-events
      path: /lists/{list_id}/members/{subscriber_hash}/events
      operations:
      - name: getlistsidmembersidevents
        method: GET
        description: Mailchimp List Member Events
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: list_id
          in: path
          type: string
          description: The unique ID for the list.
          required: true
        - name: subscriber_hash
          in: path
          type: string
          description: The MD5 hash of the lowercase version of the list member's email address. This endpoint also accepts
            a list member's email address or contact_id.
          required: true
        - 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: 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: postlistmemberevents
        method: POST
        description: Mailchimp Add Event
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: list_id
          in: path
          type: string
          description: The unique ID for the list.
          required: true
        - name: subscriber_hash
          in: path
          type: string
          description: The MD5 hash of the lowercase version of the list member's email address. This endpoint also accepts
            a list member's email address or contact_id.
          required: true
        - name: body
          in: body
          type: object
          required: true
    - name: lists-list_id-members-subscriber_hash-goals
      path: /lists/{list_id}/members/{subscriber_hash}/goals
      operations:
      - name: getlistsidmembersidgoals
        method: GET
        description: Mailchimp List Member Goal Events
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: list_id
          in: path
          type: string
          description: The unique ID for the list.
          required: true
        - name: subscriber_hash
          in: path
          type: string
          description: The MD5 hash of the lowercase version of the list member's email address. This endpoint also accepts
            a list member's email address or contact_id.
          required: true
        - 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: lists-list_id-members-subscriber_hash-notes
      path: /lists/{list_id}/members/{subscriber_hash}/notes
      operations:
      - name: getlistsidmembersidnotes
        method: GET
        description: Mailchimp List Recent Member Notes
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: list_id
          in: path
          type: string
          description: The unique ID for the list.
          required: true
        - name: subscriber_hash
          in: path
          type: string
          description: The MD5 hash of the lowercase version of the list member's email address.
          required: true
        - name: sort_field
          in: query
          type: string
          description: Returns notes sorted by the specified field.
        - name: sort_dir
          in: query
          type: string
          description: Determines the order direction for sorted results.
        - 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: postlistsidmembersidnotes
        method: POST
        description: Mailchimp Add Member Note
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: list_id
          in: path
          type: string
          description: The unique ID for the list.
          required: true
        - name: subscriber_hash
          in: path
          type: string
          description: The MD5 hash of the lowercase version of the list member's email address.
          required: true
        - name: body
          in: body
          type: object
          required: true
    - name: lists-list_id-members-subscriber_hash-notes-note_id
      path: /lists/{list_id}/members/{subscriber_hash}/notes/{note_id}
      operations:
      - name: getlistsidmembersidnotesid
        method: GET
        description: Mailchimp Get Member Note
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: list_id
          in: path
          type: string
          description: The unique ID for the list.
          required: true
        - name: subscriber_hash
          in: path
          type: string
          description: The MD5 hash of the lowercase version of the list member's email address. This endpoint also accepts
            a list member's email address or contact_id.
          required: true
        - name: note_id
          in: path
          type: string
          description: The id for the note.
          required: true
        - 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: patchlistsidmembersidnotesid
        method: PATCH
        description: Mailchimp Update Note
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: list_id
          in: path
          type: string
          description: The unique ID for the list.
          required: true
        - name: subscriber_hash
          in: path
          type: string
          description: The MD5 hash of the lowercase version of the list member's email address. This endpoint also accepts
            a list member's email address or contact_id.
          required: true
        - name: note_id
          in: path
          type: string
          description: The id for the note.
          required: true
        - name: body
          in: body
          type: object
          required: true
      - name: deletelistsidmembersidnotesid
        method: DELETE
        description: Mailchimp Delete Note
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: list_id
          in: path
          type: string
          description: The unique ID for the list.
          required: true
        - name: subscriber_hash
          in: path
          type: string
          description: The MD5 hash of the lowercase version of the list member's email address. This endpoint also accepts
            a list member's email address or contact_id.
          required: true
        - name: note_id
          in: path
          type: string
          description: The id for the note.
          required: true
    - name: lists-list_id-members-subscriber_hash-tags
      path: /lists/{list_id}/members/{subscriber_hash}/tags
      operations:
      - name: getlistmembertags
        method: GET
        description: Mailchimp List Member Tags
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: list_id
          in: path
          type: string
          description: The unique ID for the list.
          required: true
        - name: subscriber_hash
          in: path
          type: string
          description: The MD5 hash of the lowercase version of the list member's email address. This endpoint also accepts
            a list member's email address or contact_id.
          required: true
        - 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: postlistmembertags
        method: POST
        description: Mailchimp Add or Remove Member Tags
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: list_id
          in: path
          type: string
          description: The unique ID for the list.
          required: true
        - name: subscriber_hash
          in: path
          type: string
          description: The MD5 hash of the lowercase version of the list member's email address.
          required: true
        - name: body
          in: body
          type: object
          required: true
    - name: lists-list_id-segments-segment_id-members
      path: /lists/{list_id}/segments/{segment_id}/members
      operations:
      - name: getlistsidsegmentsidmembers
        method: GET
        description: Mailchimp List Members in Segment
        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: list_id
          in: path
          type: string
          description: The unique ID for the list.
          required: true
        - name: segment_id
          in: path
          type: string
          description: The unique id for the segment.
          required: true
        - name: include_cleaned
          in: query
          type: boolean
          description: Include cleaned members in response
        - name: include_transactional
          in: query
          type: boolean
          description: Include transactional members in response
        - name: include_unsubscribed
          in: query
          type: boolean
          description: Include unsubscribed members in response
      - name: postlistsidsegmentsidmembers
        method: POST
        description: Mailchimp Add Member to Segment
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: list_id
          in: path
          type: string
          description: The unique ID for the list.
          required: true
        - name: segment_id
          in: path
          type: string
          description: The unique id for the segment.
          required: true
        - name: body
          in: body
          type: object
          required: true
    - name: lists-list_id-segments-segment_id-members-subscriber_hash
      path: /lists/{list_id}/segments/{segment_id}/members/{subscriber_hash}
      operations:
      - name: deletelistsidsegmentsidmembersid
        method: DELETE
        description: Mailchimp Remove List Member From Segment
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: list_id
          in: path
          type: string
          description: The unique ID for the list.
          required: true
        - name: segment_id
          in: path
          type: string
          description: The unique id for the segment.
          required: true
        - name: subscriber_hash
          in: path
          type: string
          description: The MD5 hash of the lowercase version of the list member's email address.
          required: true
    - name: reports-campaign_id-click-details-link_id-members
      path: /reports/{campaign_id}/click-details/{link_id}/members
      operations:
      - name: getreportsidclickdetailsidmembers
        method: GET
        description: Mailchimp List Clicked Link Subscribers
        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: campaign_id
          in: path
          type: string
          description: The unique id for the campaign.
          required: true
        - name: link_id
          in: path
          type: string
          description: The id for the link.
          required: true
    - name: reports-campaign_id-click-details-link_id-members-subscriber_hash
      path: /reports/{campaign_id}/click-details/{link_id}/members/{subscriber_hash}
      operations:
      - name: getreportsidclickdetailsidmembersid
        method: GET
        description: Mailchimp Get Clicked Link Subscriber
        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: campaign_id
          in: path
          type: string
          description: The unique id for the campaign.
          required: true
        - name: link_id
          in: path
          type: string
          description: The id for the link.
          required: true
        - name: subscriber_hash
          in: path
          type: string
          description: The MD5 hash of the lowercase version of the list member's email address.
          required: true
    - name: search-members
      path: /search-members
      operations:
      - name: getsearchmembers
        method: GET
        description: Mailchimp Search Members
        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: query
          in: query
          type: string
          description: The search query used to filter results. Query should be a valid email, or a string representing a
            contact's first or last name.
          required: true
        - name: list_id
          in: query
          type: string
          description: The unique id for the list.
  exposes:
  - type: rest
    namespace: marketing-members-rest
    port: 8080
    description: REST adapter for Mailchimp Marketing 

# --- truncated at 32 KB (58 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/mailchimp/refs/heads/main/capabilities/marketing-members.yaml