Adicionar um contacto a uma audiência
Recebe um endereço que já consta do livro de endereços do workspace e devolve a associação, com o contacto para o qual aponta. Existe uma associação por audiência e contacto, pelo que adicionar alguém que já está na audiência responde `200` com o `addedAt` original, em vez de criar uma segunda ou falhar. Isso torna a chamada segura para repetir.
Executa a chamada real contra o seu espaço de trabalho, com a sua própria chave.
POST /audiences/{id}/contacts
Recebe um endereço que já consta do livro de endereços do workspace e devolve a associação, com o contacto para o qual aponta. Existe uma associação por audiência e contacto, pelo que adicionar alguém que já está na audiência responde 200 com o addedAt original, em vez de criar uma segunda ou falhar. Isso torna a chamada segura para repetir.
Exemplo
Requer 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" }}Um endereço que não seja um contacto é recusado com 422 contact_not_found, em vez de ser criado na altura. Guarde-o primeiro com POST /contacts.
audiences:write é o único âmbito verificado. Colocar um contacto numa lista não é uma escrita no contacto.
Uma chamada por contacto. Não existe adição em massa nesta versão, e apagar o contacto mais tarde arrasta consigo esta associação.