如何将联系人添加到 ActiveCampaign API v3 中的列表

Question

根据 v3 docs I should be able to add a contact to a list using the Contact API but I am at a loss on how to do so as I see nothing list related under Contacts。

如何使用 API 的第 3 版将联系人添加到列表（不是通过自动化）？还是文档有误？

Answer 1

v3 文档已更新（Lists documentation) and they no longer read that you can add a contact to a list through the API. ActiveCampaign Lists documentation screenshot

编辑：您可以使用 v1 contact_sync (contact_sync documentation) 将联系人添加到列表

第二次编辑：您现在可以将联系人添加到列表 and/or 通过 v3 API 将他们的订阅状态更改为给定列表！ (update list status for a contact documentation)

Answer 2

以上不再正确。您可以使用 Create Contact 端点添加联系人。

它基本上是一个使用以下参数的 POST 请求：

电子邮件（必填）
名字（可选）
姓氏（可选）
Phone（可选）

API v3 虽然发生了很大变化，但现在在您创建联系人以执行以下操作后，您必须咨询其他端点。例如：

要将联系人添加到列表，您需要向 Contact Lists 端点发出 POST 请求，您需要在其中提供三个参数 (listid, contactid, status).

如果您需要为联系人分配标签，为了能够创建关系，您首先需要使用 Create a new tag endpoint. And the use the resulting tag id with the Create Contact Tag 端点创建标签，在该端点您将所述标签 ID 与联系人 ID 组合在一起.

现在为了删除同一个标签，Active Campaign 的人让我们付出了更多的努力，为了从联系人中删除标签，您不使用联系人的 ID 和标签的 ID，而是必须使用联系人的id和标签与特定联系人之间的关系id，这是相当多的步骤，但我猜他们想使它在结构方面非常稳健。

从您提出问题的那一天开始，实际上有许多新的端点可用。您应该查看新的 API reference。它有一些缺陷，尚未 100% 完成，但它会很有用。

Answer 3

希望这对您有所帮助，因为它让我有些头疼...使用 activecampaign php sdk 使用同步命令添加联系人时，您还可以将其添加到列表中：

  $list_id = 'thelistid';
  $contact = array(
    "email"              => 'contactemail@doamin.com',
    "p[{$list_id}]"      => $list_id,
    "status[{$list_id}]" => 1, // "Active" status
  );

$contact_sync = $ac->api("contact/sync", $contact);

他们也在 repository 上作为示例写了它，但由于某种原因我没听懂。

如何将联系人添加到 ActiveCampaign API v3 中的列表

How to add a contact to a list in ActiveCampaign API v3

activecampaign