Saltar para a documentação
API

Remover contactos de uma audiência em massa

Retira até 200 contactos de uma audiência numa só chamada, por endereço. Cada um continua no livro de endereços, na audiência predefinida e em todas as outras audiências em que estava.

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

Executa a chamada real contra o seu espaço de trabalho, com a sua própria chave.

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

Retira até 200 contactos de uma audiência numa só chamada, por endereço. Cada um continua no livro de endereços, na audiência predefinida e em todas as outras audiências em que estava.

Exemplo

Requer audiences:write. O corpo tem a mesma forma que a adição em massa: emails com 1 a 200 endereços.

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]"]}'
Resposta
{  "object": "audience_batch",  "audienceId": "aud_4c1b8e2a7d9f05c36b4e8a71",  "removed": 1,  "notInAudience": ["[email protected]"],  "missing": ["[email protected]"]}

removed conta as associações retiradas, notInAudience lista os contactos que não estavam nesta audiência, e missing os endereços que não são contactos de todo. Nada acontece a nenhuma das listas, por isso a chamada é segura de repetir.

A audiência predefinida incorporada não pode ser reduzida. A chamada é recusada com 409 audience_immutable e nada é removido. Apague um contacto quando quiser que desapareça.