Einen Kontakt zu einer Audience hinzufügen
Nimmt eine Adresse, die bereits im Adressbuch des Workspace steht, und gibt die Mitgliedschaft samt des Kontakts zurück, auf den sie zeigt. Pro Audience und Kontakt gibt es genau eine Mitgliedschaft; wer bereits in der Audience ist, wird daher mit `200` und dem ursprünglichen `addedAt` beantwortet, statt ein zweites Mal hinzugefügt zu werden oder einen Fehler auszulösen. Damit lässt sich der Aufruf gefahrlos wiederholen.
Führt den echten Aufruf gegen Ihren Workspace aus, mit Ihrem eigenen Schlüssel.
POST /audiences/{id}/contacts
Nimmt eine Adresse, die bereits im Adressbuch des Workspace steht, und gibt die Mitgliedschaft samt des Kontakts zurück, auf den sie zeigt. Pro Audience und Kontakt gibt es genau eine Mitgliedschaft; wer bereits in der Audience ist, wird daher mit 200 und dem ursprünglichen addedAt beantwortet, statt ein zweites Mal hinzugefügt zu werden oder einen Fehler auszulösen. Damit lässt sich der Aufruf gefahrlos wiederholen.
Beispiel
Erfordert 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" }}Eine Adresse, die kein Kontakt ist, wird mit 422 contact_not_found abgelehnt und nicht spontan angelegt. Speichern Sie sie zuerst mit POST /contacts.
audiences:write ist der einzige geprüfte Scope. Einen Kontakt in eine Liste aufzunehmen ist kein Schreibzugriff auf den Kontakt.
Ein Aufruf pro Kontakt. In dieser Version gibt es kein Hinzufügen in Massen, und wird der Kontakt später gelöscht, verschwindet diese Mitgliedschaft mit ihm.