Añadir un contacto a una audiencia
Toma una dirección que ya está en la libreta del espacio de trabajo y devuelve la membresía, junto con el contacto al que apunta. Hay una membresía por audiencia y contacto, así que añadir a alguien que ya está en la audiencia responde `200` con el `addedAt` original en lugar de añadir una segunda o fallar. Eso hace que la llamada se pueda reintentar sin riesgo.
Ejecuta la llamada real contra tu espacio de trabajo, con tu propia clave.
POST /audiences/{id}/contacts
Toma una dirección que ya está en la libreta del espacio de trabajo y devuelve la membresía, junto con el contacto al que apunta. Hay una membresía por audiencia y contacto, así que añadir a alguien que ya está en la audiencia responde 200 con el addedAt original en lugar de añadir una segunda o fallar. Eso hace que la llamada se pueda reintentar sin riesgo.
Ejemplo
Requiere audiences:write.
curl -X POST "$OE/audiences/aud_4c1b8e2a7d9f05c36b4e8a71/contacts" -H "$AUTH" -H 'content-type: application/json' -d '{ "email": "[email protected]"}'{ "object": "audience_member", "audienceId": "aud_4c1b8e2a7d9f05c36b4e8a71", "addedAt": "2026-09-18T09:30:00.000Z", "contact": { "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" }}Una dirección que no es un contacto se rechaza con 422 contact_not_found en lugar de crearse sobre la marcha. Guárdala antes con POST /contacts.
audiences:write es el único ámbito que se comprueba. Poner un contacto en una lista no es una escritura sobre el contacto.
Una llamada por contacto. En esta versión no hay alta masiva, y eliminar el contacto más adelante se lleva esta membresía con él.