如何通过Wix REST API将联系人/成员添加到Segment

要将联系人添加到指定Segment，需使用Wix Contacts API的联系人更新端点，而非不存在的segment端点或用于标签的labels端点。具体信息如下：

核心端点 #

PATCH https://www.wixapis.com/contacts/v4/contacts/{CONTACT_ID}

请求要求 #

1. 请求头：需携带有效的授权令牌，格式为：

   Authorization: Bearer YOUR_ACCESS_TOKEN
   Content-Type: application/json
   

   确保令牌拥有contacts.contacts.write权限。

2. 请求体：在请求体中指定segments字段，将目标Segment ID加入items数组（若需保留原有Segment，需包含所有已存在的ID；若仅需替换为目标Segment，则只传入目标ID）。示例如下（基于你提供的Segment ID集合）：

   {
     "segments": {
       "items": [
         "cbd3c2df-a35d-47f8-a869-765c3a2ceb60",
         "ed4655da-42b9-42e8-98c0-765c3a2ceb60",
         "cbd3c2df-b3d7-4a14-42e8-765c3a2ceb60",
         "82a90edb-f42c-4d53-94e3-765c3a2ceb60",
         "ed4655da-86e5-4fe9-b53d-765c3a2ceb60",
         "NEW_SEGMENT_ID_TO_ADD"
       ]
     }
   }
   

注意事项 #

• 确认Segment ID为有效UUID格式（你提供的示例中cbd3c2df-v-42e8-9f7a-765c3a2ceb60格式不符合标准UUID，需检查是否为输入错误）。
• 该端点为全量替换segments.items数组，若仅需添加新Segment，需先获取联系人当前的Segment列表，再追加新ID后提交更新。

内容的提问来源于stack exchange，提问作者MindWire