Definir las audiencias de un contacto
Indica exactamente en qué audiencias está un contacto, en una sola llamada. El contacto se une a cada audiencia de `audienceIds` en la que aún no está y sale de todas las demás. La audiencia por defecto se conserva siempre, así que una lista vacía deja el contacto solo en la audiencia por defecto.
Ejecuta la llamada real contra tu espacio de trabajo, con tu propia clave.
PUT /contacts/{email}/audiences
Indica exactamente en qué audiencias está un contacto, en una sola llamada. El contacto se une a cada audiencia de audienceIds en la que aún no está y sale de todas las demás. La audiencia por defecto se conserva siempre, así que una lista vacía deja el contacto solo en la audiencia por defecto.
Ejemplo
Necesita audiences:write, porque escribe pertenencias y no el contacto. Codifica la @ en la URL. audienceIds admite hasta 100 ids.
curl -X PUT "$OE/contacts/grace%40example.com/audiences" -H "$AUTH" -H 'content-type: application/json' -d '{ "audienceIds": ["aud_4c1b8e2a7d9f05c36b4e8a71"]}'{ "object": "contact", "email": "[email protected]", "name": "Grace Hopper", "source": "manual", "notes": null, "lastSeenAt": null, "createdAt": "2026-09-18T09:00:00.000Z", "updatedAt": "2026-09-18T09:00:00.000Z", "audiences": [ { "id": "aud_9f2c4b7e1a0d63d84c5f2e7b", "name": "All contacts", "builtin": "default" }, { "id": "aud_4c1b8e2a7d9f05c36b4e8a71", "name": "Product updates", "builtin": null } ]}El contacto tiene que existir ya. Una dirección que no está en la libreta es un 404 contact_not_found. Créalo con POST /contacts, que también acepta audienceIds.
Un id que no nombra ninguna audiencia de este espacio de trabajo es un 404 audience_not_found y no cambia nada, así que una errata no puede sacar a nadie de una lista sin avisar. Repetir la misma llamada no cambia nada.
La respuesta es el contacto tal como lo devuelve GET /contacts/{email}, con todas las audiencias en las que está tras el cambio.