如何通过API将Mailchimp联系人设置为Not-Subscribed状态

核心说明 #

Mailchimp界面展示的Not-Subscribed为系统内置状态，早期API文档未明确标注对应传值，你可以通过以下两种方式实现目标需求： #

方案1：直接使用API对应枚举值 #

Mailchimp API v3 最新版本已支持"not_subscribed"作为合法状态传值：

• 添加联系人时直接传入status: "not_subscribed"即可将联系人标记为未订阅状态
• 该操作不会触发任何用户通知，后续可正常调用接口更新为"subscribed"或"unsubscribed"状态

方案2：兼容旧版API的替代实现 #

如果你使用的旧版API不支持上述枚举值，可使用参数组合实现相同效果：

1. 添加联系人时传入status: "pending"
2. 同时在请求体中添加double_optin: false、send_welcome: false两个参数
3. 该操作不会触发确认邮件，联系人处于待确认中间态，后续可直接调用接口覆盖状态即可

注意事项 #

• 禁止使用"cleaned"状态作为中间值，该状态为系统标记的无效联系人，一旦设置后无法恢复为可订阅状态
• 若有业务自定义的中间状态需求，建议额外添加联系人自定义字段存储，避免与Mailchimp内置状态逻辑冲突

内容的提问来源于stack exchange，提问作者Sami.C