Aller à la documentation
API

Retirer des contacts d'une audience en masse

Retire jusqu'à 200 contacts d'une audience en un seul appel, par adresse. Chacun reste dans le carnet d'adresses, dans l'audience par défaut et dans toutes les autres audiences où il se trouvait.

POSTapi.openemail.uk/audiences/{id}/contacts/batch-remove

Exécute le véritable appel sur votre espace de travail, avec votre propre clé.

POST /audiences/{id}/contacts/batch-remove

Retire jusqu'à 200 contacts d'une audience en un seul appel, par adresse. Chacun reste dans le carnet d'adresses, dans l'audience par défaut et dans toutes les autres audiences où il se trouvait.

Exemple

Nécessite audiences:write. Le corps a la même forme que l'ajout en masse : emails avec 1 à 200 adresses.

curl
curl -X POST "$OE/audiences/aud_4c1b8e2a7d9f05c36b4e8a71/contacts/batch-remove" -H "$AUTH" -H 'content-type: application/json' -d '{  "emails": ["[email protected]", "[email protected]", "[email protected]"]}'
Réponse
{  "object": "audience_batch",  "audienceId": "aud_4c1b8e2a7d9f05c36b4e8a71",  "removed": 1,  "notInAudience": ["[email protected]"],  "missing": ["[email protected]"]}

removed compte les appartenances retirées, notInAudience liste les contacts qui n'étaient pas dans cette audience, et missing les adresses qui ne sont pas du tout des contacts. Rien n'arrive aux unes ni aux autres, donc l'appel peut être rejoué sans risque.

L'audience par défaut intégrée ne peut pas être réduite. L'appel est refusé avec 409 audience_immutable et rien n'est retiré. Supprimez un contact quand vous voulez qu'il parte.