API

Einen Kontakt aktualisieren

Eine partielle Aktualisierung, niemals ein Upsert. Ein weggelassenes Feld behält seinen gespeicherten Wert, ein ausdrückliches `null` leert es; `{"notes": null}` leert also die Notizen, während `{}` nichts ändert. Eine Adresse, die nicht im Adressbuch steht, ergibt ein `404`.

PATCHapi.openemail.uk/contacts/{email}

Führt den echten Aufruf gegen Ihren Workspace aus, mit Ihrem eigenen Schlüssel.

PATCH /contacts/{email}

Eine partielle Aktualisierung, niemals ein Upsert. Ein weggelassenes Feld behält seinen gespeicherten Wert, ein ausdrückliches null leert es; {"notes": null} leert also die Notizen, während {} nichts ändert. Eine Adresse, die nicht im Adressbuch steht, ergibt ein 404.

Beispiel

Erfordert contacts:write. Das @ URL-kodieren.

curl

curl -X PATCH "$OE/contacts/grace%40example.com" -H "$AUTH" -H 'content-type: application/json' -d '{  "name": "Grace Hopper",  "notes": null}'

Antwort

{  "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:04:00.000Z",  "audiences": [    { "id": "aud_9f2c4b7e1a0d63d84c5f2e7b", "name": "All contacts", "builtin": "default" }  ]}

Die Adresse lässt sich hier nicht ändern. Sie ist die Identität, das Pfadsegment und der eindeutige Schlüssel des Adressbuchs; einen Kontakt auf eine neue Adresse umzuziehen bedeutet also Löschen und Neuanlegen.

Ein automatisch erfasster Kontakt bleibt auto, auch nachdem Sie ihm einen Namen gegeben haben. Ihn zu benennen ist nicht dieselbe Aussage, wie dass jemand ihn gespeichert hätte.

Die Audience-Mitgliedschaft bleibt unberührt. Verwenden Sie dafür die Audience-Routen.