Die Audiences eines Kontakts festlegen
Legt in einem Aufruf genau fest, in welchen Audiences ein Kontakt ist. Der Kontakt tritt jeder Audience in `audienceIds` bei, in der er noch nicht ist, und verlässt jede andere. Die Standard-Audience bleibt immer erhalten, eine leere Liste lässt den Kontakt also nur in der Standard-Audience.
Führt den echten Aufruf gegen Ihren Workspace aus, mit Ihrem eigenen Schlüssel.
PUT /contacts/{email}/audiences
Legt in einem Aufruf genau fest, in welchen Audiences ein Kontakt ist. Der Kontakt tritt jeder Audience in audienceIds bei, in der er noch nicht ist, und verlässt jede andere. Die Standard-Audience bleibt immer erhalten, eine leere Liste lässt den Kontakt also nur in der Standard-Audience.
Beispiel
Erfordert audiences:write, weil Mitgliedschaften geschrieben werden und nicht der Kontakt. Das @ URL-kodieren. audienceIds fasst bis zu 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 } ]}Der Kontakt muss bereits existieren. Eine Adresse, die nicht im Adressbuch steht, ergibt ein 404 contact_not_found. Legen Sie ihn mit POST /contacts an, das ebenfalls audienceIds annimmt.
Eine ID, die keine Audience in diesem Workspace bezeichnet, ergibt ein 404 audience_not_found, und nichts ändert sich; ein Tippfehler kann also niemanden stillschweigend aus einer Liste nehmen. Derselbe Aufruf ein zweites Mal ändert nichts.
Die Antwort ist der Kontakt, wie GET /contacts/{email} ihn liefert, mit jeder Audience, in der er nach der Änderung ist.