Ir a la documentación
API

Quitar contactos de una audiencia en bloque

Saca hasta 200 contactos de una audiencia en una sola llamada, por dirección. Cada uno sigue en la libreta de direcciones, en la audiencia por defecto y en todas las demás audiencias en las que estaba.

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

Ejecuta la llamada real contra tu espacio de trabajo, con tu propia clave.

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

Saca hasta 200 contactos de una audiencia en una sola llamada, por dirección. Cada uno sigue en la libreta de direcciones, en la audiencia por defecto y en todas las demás audiencias en las que estaba.

Ejemplo

Necesita audiences:write. El cuerpo tiene la misma forma que el alta en bloque: emails con de 1 a 200 direcciones.

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

removed cuenta las membresías quitadas, notInAudience lista los contactos que no estaban en esta audiencia, y missing las direcciones que no son contactos en absoluto. No se hace nada con ninguna de las dos listas, así que la llamada se puede repetir sin riesgo.

La audiencia por defecto integrada no se puede reducir. La llamada se rechaza con 409 audience_immutable y no se quita nada. Elimina el contacto cuando quieras que desaparezca.