Crear una audiencia
Crea una audiencia nueva y vacía y la devuelve con su id. A `name` se le recortan los espacios y después debe tener entre 1 y 120 caracteres. `description` es texto libre opcional para quien lea la lista más adelante. Los nombres no se comprueban contra duplicados, porque una audiencia se direcciona por su id.
Ejecuta la llamada real contra tu espacio de trabajo, con tu propia clave.
POST /audiences
Crea una audiencia nueva y vacía y la devuelve con su id. A name se le recortan los espacios y después debe tener entre 1 y 120 caracteres. description es texto libre opcional para quien lea la lista más adelante. Los nombres no se comprueban contra duplicados, porque una audiencia se direcciona por su id.
Ejemplo
Requiere audiences:write.
curl -X POST "$OE/audiences" -H "$AUTH" -H 'content-type: application/json' -d '{ "name": "Product updates", "description": "Customers who asked to hear about releases"}'{ "object": "audience", "id": "aud_4c1b8e2a7d9f05c36b4e8a71", "name": "Product updates", "description": "Customers who asked to hear about releases", "builtin": null, "contactCount": 0, "createdAt": "2026-09-18T09:10:00.000Z", "updatedAt": "2026-09-18T09:10:00.000Z"}builtin nunca se acepta desde el cuerpo. Exactamente una fila por espacio de trabajo lo lleva, y esa fila es del servidor.
Un espacio de trabajo admite como máximo 100 audiencias. La siguiente se rechaza con 422 audience_limit_reached sobre name.
Llénala con la ruta de alta, de un contacto en un contacto, y los contactos ya tienen que estar en la libreta.