API

オーディエンスから連絡先を削除する

メンバーシップを 1 つ削除し、それ以外には手を触れません。連絡先はアドレス帳に残り、デフォルトオーディエンスにも、入っていた他のすべてのオーディエンスにも残ります。

DELETEapi.openemail.uk/audiences/{id}/contacts/{email}

実際の呼び出しを、ご自身のキーで自分のワークスペースに対して実行します。

DELETE /audiences/{id}/contacts/{email}

audiences:write が必要です。@ は URL エンコードしてください。

curl

curl -X DELETE "$OE/audiences/aud_4c1b8e2a7d9f05c36b4e8a71/contacts/grace%40example.com" -H "$AUTH"

レスポンス

{  "object": "audience_member",  "audienceId": "aud_4c1b8e2a7d9f05c36b4e8a71",  "email": "[email protected]",  "deleted": true}

このオーディエンスに入っていない連絡先は 404 になります。そのため、打ち間違いが、実際には起きていない削除を成功として報告することはありません。

組み込みのデフォルトオーディエンスからは取り除けません。その呼び出しは 409 audience_immutable で拒否されます。連絡先である限り、すべての連絡先を保持し続けるものだからです。連絡先そのものを消したいときは、連絡先を削除してください。

最後の連絡先を削除しても、オーディエンスは空のまま残ります。