API

Einen Kontakt speichern

Macht, was Zu Kontakten hinzufügen und In Kontakten behalten in der App tun, und ist in jedem Zustand der Adresse sicher. Eine Adresse, die noch kein Kontakt ist, wird einer, beantwortet mit `201`. Eine aus einem Versand erfasste wird `manual`, und eine schon gespeicherte behält, was sie hat, beantwortet mit `200`. Eine gelöschte Adresse wird zurückgeholt. Der Body ist optional.

PUTapi.openemail.uk/contacts/{email}

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

PUT /contacts/{email}

Macht, was Zu Kontakten hinzufügen und In Kontakten behalten in der App tun, und ist in jedem Zustand der Adresse sicher. Eine Adresse, die noch kein Kontakt ist, wird einer, beantwortet mit 201. Eine aus einem Versand erfasste wird manual, und eine schon gespeicherte behält, was sie hat, beantwortet mit 200. Eine gelöschte Adresse wird zurückgeholt. Der Body ist optional.

Beispiel

Erfordert contacts:write. Das @ URL-kodieren.

curl

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

Antwort

{  "object": "contact",  "email": "[email protected]",  "name": "Grace Hopper",  "source": "manual",  "notes": null,  "photoUrl": null,  "lastSeenAt": "2026-09-20T12:00:00.000Z",  "createdAt": "2026-09-02T08:00:00.000Z",  "updatedAt": "2026-09-23T10:15:00.000Z",  "audiences": [    { "id": "aud_9f2c4b7e1a0d63d84c5f2e7b", "name": "All contacts", "builtin": "default" }  ]}

name ersetzt den gespeicherten Namen, und wird er weggelassen, bleibt er. notes ersetzt die gespeicherten Notizen, und null leert sie. Jeder andere Schlüssel ist ein 422 unknown_parameter.

Anders als bei POST /contacts ist eine Adresse, die schon im Adressbuch steht, kein 409; anders als bei PATCH ist eine Adresse, die nicht im Adressbuch steht, kein 404. Ein neuer Kontakt kommt in die Standard-Audience.