Ir a la documentación
API

Vaciar una audiencia

Saca todos los contactos de la audiencia en una sola transacción. La audiencia se queda, con su id, su nombre y su descripción, y cada contacto sigue en la libreta de direcciones, en la audiencia por defecto y en sus otras audiencias.

POSTapi.openemail.uk/audiences/{id}/empty

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

POST /audiences/{id}/empty

Saca todos los contactos de la audiencia en una sola transacción. La audiencia se queda, con su id, su nombre y su descripción, y cada contacto sigue en la libreta de direcciones, en la audiencia por defecto y en sus otras audiencias.

Ejemplo

Necesita audiences:write. No lleva cuerpo.

curl
curl -X POST "$OE/audiences/aud_4c1b8e2a7d9f05c36b4e8a71/empty" -H "$AUTH"
Respuesta
{  "object": "audience",  "id": "aud_4c1b8e2a7d9f05c36b4e8a71",  "name": "Product updates",  "description": "Customers who asked to hear about releases",  "builtin": null,  "contactCount": 0,  "lastContactAt": null,  "createdAt": "2026-09-18T09:10:00.000Z",  "updatedAt": "2026-09-18T09:10:00.000Z",  "removed": 3}

La respuesta es la audiencia tal como queda, más removed, el número de pertenencias quitadas. Vaciar una audiencia que ya está vacía responde removed: 0.

No hay deshacer, y nada registra quién estaba en la lista. Recorre GET /audiences/{id}/contacts antes si puede que la quieras de vuelta. La app pide a la persona que confirme quién es antes de vaciar una lista, y una clave no tiene ese paso, así que concede audiences:write a conciencia.

La audiencia por defecto integrada no se puede vaciar. Esa llamada se rechaza con 409 audience_immutable.