Ga direct naar de documentatie
API

Een contact uit een audience verwijderen

Laat één lidmaatschap vervallen en laat al het andere met rust. Het contact blijft in het adresboek, blijft in de standaard-audience en blijft in elke andere audience waar het in zat.

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

Voert de echte aanroep uit op je workspace, met je eigen sleutel.

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

Laat één lidmaatschap vervallen en laat al het andere met rust. Het contact blijft in het adresboek, blijft in de standaard-audience en blijft in elke andere audience waar het in zat.

Voorbeeld

Vereist audiences:write. URL-encodeer de @.

curl
curl -X DELETE "$OE/audiences/aud_4c1b8e2a7d9f05c36b4e8a71/contacts/grace%40example.com" -H "$AUTH"
Antwoord
{  "object": "audience_member",  "audienceId": "aud_4c1b8e2a7d9f05c36b4e8a71",  "email": "[email protected]",  "deleted": true}

Een contact dat niet in deze audience zit levert een 404 op, zodat een typefout geen verwijdering kan melden die nooit heeft plaatsgevonden.

De ingebouwde standaard-audience kan niet worden uitgedund. Die aanroep wordt geweigerd met 409 audience_immutable, omdat hij elk contact bevat zolang het een contact is. Verwijder het contact als je bedoelt dat het contact weg moet.

Het laatste contact verwijderen laat de audience leeg achter, maar hij blijft bestaan.