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 API — Members. One Spectral-compliant resource per consumed operation, prefixed with /v1. resources: - path: /v1/lists/{list-id}/members name: lists-list-id-members description: REST surface for lists-list_id-members. operations: - method: GET name: getlistsidmembers description: Mailchimp List Members Info call: marketing-members.getlistsidmembers with: fields: rest.fields exclude_fields: rest.exclude_fields count: rest.count offset: rest.offset list_id: rest.list_id email_type: rest.email_type status: rest.status since_timestamp_opt: rest.since_timestamp_opt before_timestamp_opt: rest.before_timestamp_opt since_last_changed: rest.since_last_changed before_last_changed: rest.before_last_changed unique_email_id: rest.unique_email_id vip_only: rest.vip_only interest_category_id: rest.interest_category_id interest_ids: rest.interest_ids interest_match: rest.interest_match sort_field: rest.sort_field sort_dir: rest.sort_dir since_last_campaign: rest.since_last_campaign unsubscribed_since: rest.unsubscribed_since outputParameters: - type: object mapping: $. - method: POST name: postlistsidmembers description: Mailchimp Add Member to List call: marketing-members.postlistsidmembers with: list_id: rest.list_id skip_merge_validation: rest.skip_merge_validation body: rest.body outputParameters: - type: object mapping: $. - path: /v1/lists/{list-id}/members/{subscriber-hash} name: lists-list-id-members-subscriber-hash description: REST surface for lists-list_id-members-subscriber_hash. operations: - method: GET name: getlistsidmembersid description: Mailchimp Get Member Info call: marketing-members.getlistsidmembersid with: fields: rest.fields exclude_fields: rest.exclude_fields list_id: rest.list_id subscriber_hash: rest.subscriber_hash outputParameters: - type: object mapping: $. - method: PUT name: putlistsidmembersid description: Mailchimp Add or Update List Member call: marketing-members.putlistsidmembersid with: list_id: rest.list_id subscriber_hash: rest.subscriber_hash skip_merge_validation: rest.skip_merge_validation body: rest.body outputParameters: - type: object mapping: $. - method: PATCH name: patchlistsidmembersid description: Mailchimp Update List Member call: marketing-members.patchlistsidmembersid with: list_id: rest.list_id subscriber_hash: rest.subscriber_hash skip_merge_validation: rest.skip_merge_validation body: rest.body outputParameters: - type: object mapping: $. - method: DELETE name: deletelistsidmembersid description: Mailchimp Archive List Member call: marketing-members.deletelistsidmembersid with: list_id: rest.list_id subscriber_hash: rest.subscriber_hash outputParameters: - type: object mapping: $. - path: /v1/lists/{list-id}/members/{subscriber-hash}/actions/delete-permanent name: lists-list-id-members-subscriber-hash-actions-delete-permanent description: REST surface for lists-list_id-members-subscriber_hash-actions-delete-permanent. operations: - method: POST name: postlistsidmembershashactionsdeletepermanent description: Mailchimp Delete List Member call: marketing-members.postlistsidmembershashactionsdeletepermanent with: list_id: rest.list_id subscriber_hash: rest.subscriber_hash outputParameters: - type: object mapping: $. - path: /v1/lists/{list-id}/members/{subscriber-hash}/activity name: lists-list-id-members-subscriber-hash-activity description: REST surface for lists-list_id-members-subscriber_hash-activity. operations: - method: GET name: getlistsidmembersidactivity description: Mailchimp View Recent Activity 50 call: marketing-members.getlistsidmembersidactivity with: list_id: rest.list_id subscriber_hash: rest.subscriber_hash fields: rest.fields exclude_fields: rest.exclude_fields action: rest.action outputParameters: - type: object mapping: $. - path: /v1/lists/{list-id}/members/{subscriber-hash}/activity-feed name: lists-list-id-members-subscriber-hash-activity-feed description: REST surface for lists-list_id-members-subscriber_hash-activity-feed. operations: - method: GET name: getlistsidmembersidactivityfeed description: Mailchimp View Recent Activity call: marketing-members.getlistsidmembersidactivityfeed with: list_id: rest.list_id subscriber_hash: rest.subscriber_hash fields: rest.fields exclude_fields: rest.exclude_fields count: rest.count offset: rest.offset activity_filters: rest.activity_filters outputParameters: - type: object mapping: $. - path: /v1/lists/{list-id}/members/{subscriber-hash}/events name: lists-list-id-members-subscriber-hash-events description: REST surface for lists-list_id-members-subscriber_hash-events. operations: - method: GET name: getlistsidmembersidevents description: Mailchimp List Member Events call: marketing-members.getlistsidmembersidevents with: list_id: rest.list_id subscriber_hash: rest.subscriber_hash count: rest.count offset: rest.offset fields: rest.fields exclude_fields: rest.exclude_fields outputParameters: - type: object mapping: $. - method: POST name: postlistmemberevents description: Mailchimp Add Event call: marketing-members.postlistmemberevents with: list_id: rest.list_id subscriber_hash: rest.subscriber_hash body: rest.body outputParameters: - type: object mapping: $. - path: /v1/lists/{list-id}/members/{subscriber-hash}/goals name: lists-list-id-members-subscriber-hash-goals description: REST surface for lists-list_id-members-subscriber_hash-goals. operations: - method: GET name: getlistsidmembersidgoals description: Mailchimp List Member Goal Events call: marketing-members.getlistsidmembersidgoals with: list_id: rest.list_id subscriber_hash: rest.subscriber_hash fields: rest.fields exclude_fields: rest.exclude_fields outputParameters: - type: object mapping: $. - path: /v1/lists/{list-id}/members/{subscriber-hash}/notes name: lists-list-id-members-subscriber-hash-notes description: REST surface for lists-list_id-members-subscriber_hash-notes. operations: - method: GET name: getlistsidmembersidnotes description: Mailchimp List Recent Member Notes call: marketing-members.getlistsidmembersidnotes with: list_id: rest.list_id subscriber_hash: rest.subscriber_hash sort_field: rest.sort_field sort_dir: rest.sort_dir fields: rest.fields exclude_fields: rest.exclude_fields count: rest.count offset: rest.offset outputParameters: - type: object mapping: $. - method: POST name: postlistsidmembersidnotes description: Mailchimp Add Member Note call: marketing-members.postlistsidmembersidnotes with: list_id: rest.list_id subscriber_hash: rest.subscriber_hash body: rest.body outputParameters: - type: object mapping: $. - path: /v1/lists/{list-id}/members/{subscriber-hash}/notes/{note-id} name: lists-list-id-members-subscriber-hash-notes-note-id description: REST surface for lists-list_id-members-subscriber_hash-notes-note_id. operations: - method: GET name: getlistsidmembersidnotesid description: Mailchimp Get Member Note call: marketing-members.getlistsidmembersidnotesid with: list_id: rest.list_id subscriber_hash: rest.subscriber_hash note_id: rest.note_id fields: rest.fields exclude_fields: rest.exclude_fields outputParameters: - type: object mapping: $. - method: PATCH name: patchlistsidmembersidnotesid description: Mailchimp Update Note call: marketing-members.patchlistsidmembersidnotesid with: list_id: rest.list_id subscriber_hash: rest.subscriber_hash note_id: rest.note_id body: rest.body outputParameters: - type: object mapping: $. - method: DELETE name: deletelistsidmembersidnotesid description: Mailchimp Delete Note call: marketing-members.deletelistsidmembersidnotesid with: list_id: rest.list_id subscriber_hash: rest.subscriber_hash note_id: rest.note_id outputParameters: - type: object mapping: $. - path: /v1/lists/{list-id}/members/{subscriber-hash}/tags name: lists-list-id-members-subscriber-hash-tags description: REST surface for lists-list_id-members-subscriber_hash-tags. operations: - method: GET name: getlistmembertags description: Mailchimp List Member Tags call: marketing-members.getlistmembertags with: list_id: rest.list_id subscriber_hash: rest.subscriber_hash fields: rest.fields exclude_fields: rest.exclude_fields count: rest.count offset: rest.offset outputParameters: - type: object mapping: $. - method: POST name: postlistmembertags description: Mailchimp Add or Remove Member Tags call: marketing-members.postlistmembertags with: list_id: rest.list_id subscriber_hash: rest.subscriber_hash body: rest.body outputParameters: - type: object mapping: $. - path: /v1/lists/{list-id}/segments/{segment-id}/members name: lists-list-id-segments-segment-id-members description: REST surface for lists-list_id-segments-segment_id-members. operations: - method: GET name: getlistsidsegmentsidmembers description: Mailchimp List Members in Segment call: marketing-members.getlistsidsegmentsidmembers with: fields: rest.fields exclude_fields: rest.exclude_fields count: rest.count offset: rest.offset list_id: rest.list_id segment_id: rest.segment_id include_cleaned: rest.include_cleaned include_transactional: rest.include_transactional include_unsubscribed: rest.include_unsubscribed outputParameters: - type: object mapping: $. - method: POST name: postlistsidsegmentsidmembers description: Mailchimp Add Member to Segment call: marketing-members.postlistsidsegmentsidmembers with: list_id: rest.list_id segment_id: rest.segment_id body: rest.body outputParameters: - type: object mapping: $. - path: /v1/lists/{list-id}/segments/{segment-id}/members/{subscriber-hash} name: lists-list-id-segments-segment-id-members-subscriber-hash description: REST surface for lists-list_id-segments-segment_id-members-subscriber_hash. operations: - method: DELETE name: deletelistsidsegmentsidmembersid description: Mailchimp Remove List Member From Segment call: marketing-members.deletelistsidsegmentsidmembersid with: list_id: rest.list_id segment_id: rest.segment_id subscriber_hash: rest.subscriber_hash outputParameters: - type: object mapping: $. - path: /v1/reports/{campaign-id}/click-details/{link-id}/members name: reports-campaign-id-click-details-link-id-members description: REST surface for reports-campaign_id-click-details-link_id-members. operations: - method: GET name: getreportsidclickdetailsidmembers description: Mailchimp List Clicked Link Subscribers call: marketing-members.getreportsidclickdetailsidmembers with: fields: rest.fields exclude_fields: rest.exclude_fields count: rest.count offset: rest.offset campaign_id: rest.campaign_id link_id: rest.link_id outputParameters: - type: object mapping: $. - path: /v1/reports/{campaign-id}/click-details/{link-id}/members/{subscriber-hash} name: reports-campaign-id-click-details-link-id-members-subscriber-hash description: REST surface for reports-campaign_id-click-details-link_id-members-subscriber_hash. operations: - method: GET name: getreportsidclickdetailsidmembersid description: Mailchimp Get Clicked Link Subscriber call: marketing-members.getreportsidclickdetailsidmembersid with: fields: rest.fields exclude_fields: rest.exclude_fields campaign_id: rest.campaign_id link_id: rest.link_id subscriber_hash: rest.subscriber_hash outputParameters: - type: object mapping: $. - path: /v1/search-members name: search-members description: REST surface for search-members. operations: - method: GET name: getsearchmembers description: Mailchimp Search Members call: marketing-members.getsearchmembers with: fields: rest.fields exclude_fields: rest.exclude_fields query: rest.query list_id: rest.list_id outputParameters: - type: object mapping: $. - type: mcp namespace: marketing-members-mcp port: 9090 transport: http description: MCP adapter for Mailchimp Marketing API — Members. One tool per consumed operation, routed inline through this capability's consumes block. tools: - name: mailchimp-list-members-info description: Mailchimp List Members Info hints: readOnly: true destructive: false idempotent: true call: marketing-members.getlistsidmembers with: fields: tools.fields exclude_fields: tools.exclude_fields count: tools.count offset: tools.offset list_id: tools.list_id email_type: tools.email_type status: tools.status since_timestamp_opt: tools.since_timestamp_opt before_timestamp_opt: tools.before_timestamp_opt since_last_changed: tools.since_last_changed before_last_changed: tools.before_last_changed unique_email_id: tools.unique_email_id vip_only: tools.vip_only interest_category_id: tools.interest_category_id interest_ids: tools.interest_ids interest_match: tools.interest_match sort_field: tools.sort_field sort_dir: tools.sort_dir since_last_campaign: tools.since_last_campaign unsubscribed_since: tools.unsubscribed_since outputParameters: - type: object mapping: $. - name: mailchimp-add-member-list description: Mailchimp Add Member to List hints: readOnly: false destructive: false idempotent: false call: marketing-members.postlistsidmembers with: list_id: tools.list_id skip_merge_validation: tools.skip_merge_validation body: tools.body outputParameters: - type: object mapping: $. - name: mailchimp-get-member-info description: Mailchimp Get Member Info hints: readOnly: true destructive: false idempotent: true call: marketing-members.getlistsidmembersid with: fields: tools.fields exclude_fields: tools.exclude_fields list_id: tools.list_id subscriber_hash: tools.subscriber_hash outputParameters: - type: object mapping: $. - name: mailchimp-add-update-list-member description: Mailchimp Add or Update List Member hints: readOnly: false destructive: false idempotent: true call: marketing-members.putlistsidmembersid with: list_id: tools.list_id subscriber_hash: tools.subscriber_hash skip_merge_validation: tools.skip_merge_validation body: tools.body outputParameters: - type: object mapping: $. - name: mailchimp-update-list-member description: Mailchimp Update List Member hints: readOnly: false destructive: false idempotent: true call: marketing-members.patchlistsidmembersid with: list_id: tools.list_id subscriber_hash: tools.subscriber_hash skip_merge_validation: tools.skip_merge_validation body: tools.body outputParameters: - type: object mapping: $. - name: mailchimp-archive-list-member description: Mailchimp Archive List Member hints: readOnly: false destructive: true idempotent: true call: marketing-members.deletelistsidmembersid with: list_id: tools.list_id subscriber_hash: tools.subscriber_hash outputParameters: - type: object mapping: $. - name: mailchimp-delete-list-member description: Mailchimp Delete List Member hints: readOnly: true destructive: false idempotent: false call: marketing-members.postlistsidmembershashactionsdeletepermanent with: list_id: tools.list_id subscriber_hash: tools.subscriber_hash outputParameters: - type: object mapping: $. - name: mailchimp-view-recent-activity-50 description: Mailchimp View Recent Activity 50 hints: readOnly: true destructive: false idempotent: true call: marketing-members.getlistsidmembersidactivity with: list_id: tools.list_id subscriber_hash: tools.subscriber_hash fields: tools.fields exclude_fields: tools.exclude_fields action: tools.action outputParameters: - type: object mapping: $. - name: mailchimp-view-recent-activity description: Mailchimp View Recent Activity hints: readOnly: true destructive: false idempotent: true call: marketing-members.getlistsidmembersidactivityfeed with: list_id: tools.list_id subscriber_hash: tools.subscriber_hash fields: tools.fields exclude_fields: tools.exclude_fields count: tools.count offset: tools.offset activity_filters: tools.activity_filters outputParameters: - type: object mapping: $. - name: mailchimp-list-member-events description: Mailchimp List Member Events hints: readOnly: true destructive: false idempotent: true call: marketing-members.getlistsidmembersidevents with: list_id: tools.list_id subscriber_hash: tools.subscriber_hash count: tools.count offset: tools.offset fields: tools.fields exclude_fields: tools.exclude_fields outputParameters: - type: object mapping: $. - name: mailchimp-add-event description: Mailchimp Add Event hints: readOnly: false destructive: false idempotent: false call: marketing-members.postlistmemberevents with: list_id: tools.list_id subscriber_hash: tools.subscriber_hash body: tools.body outputParameters: - type: object mapping: $. - name: mailchimp-list-member-goal-events description: Mailchimp List Member Goal Events hints: readOnly: true destructive: false idempotent: true call: marketing-members.getlistsidmembersidgoals with: list_id: tools.list_id subscriber_hash: tools.subscriber_hash fields: tools.fields exclude_fields: tools.exclude_fields outputParameters: - type: object mapping: $. - name: mailchimp-list-recent-member-notes description: Mailchimp List Recent Member Notes hints: readOnly: true destructive: false idempotent: true call: marketing-members.getlistsidmembersidnotes with: list_id: tools.list_id subscriber_hash: tools.subscriber_hash sort_field: tools.sort_field sort_dir: tools.sort_dir fields: tools.fields exclude_fields: tools.exclude_fields count: tools.count offset: tools.offset outputParameters: - type: object mapping: $. - name: mailchimp-add-member-note description: Mailchimp Add Member Note hints: readOnly: false destructive: false idempotent: false call: marketing-members.postlistsidmembersidnotes with: list_id: tools.list_id subscriber_hash: tools.subscriber_hash body: tools.body outputParameters: - type: object mapping: $. - name: mailchimp-get-member-note description: Mailchimp Get Member Note hints: readOnly: true destructive: false idempotent: true call: marketing-members.getlistsidmembersidnotesid with: list_id: tools.list_id subscriber_hash: tools.subscriber_hash note_id: tools.note_id fields: tools.fields exclude_fields: tools.exclude_fields outputParameters: - type: object mapping: $. - name: mailchimp-update-note description: Mailchimp Update Note hints: readOnly: false destructive: false idempotent: true call: marketing-members.patchlistsidmembersidnotesid with: list_id: tools.list_id subscriber_hash: tools.subscriber_hash note_id: tools.note_id body: tools.body outputParameters: - type: object mapping: $. - name: mailchimp-delete-note description: Mailchimp Delete Note hints: readOnly: false destructive: true idempotent: true call: marketing-members.deletelistsidmembersidnotesid with: list_id: tools.list_id subscriber_hash: tools.subscriber_hash note_id: tools.note_id outputParameters: - type: object mapping: $. - name: mailchimp-list-member-tags description: Mailchimp List Member Tags hints: readOnly: true destructive: false idempotent: true call: marketing-members.getlistmembertags with: list_id: tools.list_id subscriber_hash: tools.subscriber_hash fields: tools.fields exclude_fields: tools.exclude_fields count: tools.count offset: tools.offset outputParameters: - type: object mapping: $. - name: mailchimp-add-remove-member-tags description: Mailchimp Add or Remove Member Tags hints: readOnly: false destructive: false idempotent: false call: marketing-members.postlistmembertags with: list_id: tools.list_id subscriber_hash: tools.subscriber_hash body: tools.body outputParameters: - type: object mapping: $. - name: mailchimp-list-members-segment description: Mailchimp List Members in Segment hints: readOnly: true destructive: false idempotent: true call: marketing-members.getlistsidsegmentsidmembers with: fields: tools.fields exclude_fields: tools.exclude_fields count: tools.count offset: tools.offset list_id: tools.list_id segment_id: tools.segment_id include_cleaned: tools.include_cleaned include_transactional: tools.include_transactional include_unsubscribed: tools.include_unsubscribed outputParameters: - type: object mapping: $. - name: mailchimp-add-member-segment description: Mailchimp Add Member to Segment hints: readOnly: false destructive: false idempotent: false call: marketing-members.postlistsidsegmentsidmembers with: list_id: tools.list_id segment_id: tools.segment_id body: tools.body outputParameters: - type: object mapping: $. - name: mailchimp-remove-list-member-segment description: Mailchimp Remove List Member From Segment hints: readOnly: false destructive: true idempotent: true call: marketing-members.deletelistsidsegmentsidmembersid with: list_id: tools.list_id segment_id: tools.segment_id subscriber_hash: tools.subscriber_hash outputParameters: - type: object mapping: $. - name: mailchimp-list-clicked-link-subscribers description: Mailchimp List Clicked Link Subscribers hints: readOnly: true destructive: false idempotent: true call: marketing-members.getreportsidclickdetailsidmembers with: fields: tools.fields exclude_fields: tools.exclude_fields count: tools.count offset: tools.offset campaign_id: tools.campaign_id link_id: tools.link_id outputParameters: - type: object mapping: $. - name: mailchimp-get-clicked-link-subscriber description: Mailchimp Get Clicked Link Subscriber hints: readOnly: true destructive: false idempotent: true call: marketing-members.getreportsidclickdetailsidmembersid with: fields: tools.fields exclude_fields: tools.exclude_fields campaign_id: tools.campaign_id link_id: tools.link_id subscriber_hash: tools.subscriber_hash outputParameters: - type: object mapping: $. - name: mailchimp-search-members description: Mailchimp Search Members hints: readOnly: true destructive: false idempotent: true call: marketing-members.getsearchmembers with: fields: tools.fields exclude_fields: tools.exclude_fields query: tools.query list_id: tools.list_id outputParameters: - type: object mapping: $.