API

Aktualizowanie kontaktu

Aktualizacja częściowa, nigdy upsert. Pominięte pole zachowuje zapisaną wartość, a jawny `null` je czyści, więc `{"notes": null}` opróżnia notatki, a `{}` niczego nie zmienia. Adres, którego nie ma w książce adresowej, daje `404`.

PATCHapi.openemail.uk/contacts/{email}

Uruchamia prawdziwe wywołanie na twojej przestrzeni roboczej, twoim własnym kluczem.

PATCH /contacts/{email}

Aktualizacja częściowa, nigdy upsert. Pominięte pole zachowuje zapisaną wartość, a jawny null je czyści, więc {"notes": null} opróżnia notatki, a {} niczego nie zmienia. Adres, którego nie ma w książce adresowej, daje 404.

Przykład

Wymaga contacts:write. Zakoduj @ w adresie URL.

curl

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

Odpowiedź

{  "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" }  ]}

Adresu nie da się tutaj zmienić. Jest tożsamością, segmentem ścieżki i kluczem unikalnym książki adresowej, więc przeniesienie kontaktu na nowy adres to usunięcie i utworzenie.

Kontakt zapisany automatycznie pozostaje auto także po nadaniu mu nazwy. Nadanie nazwy to nie to samo twierdzenie co zapisanie go przez kogoś.

Przynależność do grup odbiorców pozostaje nietknięta. Służą do tego endpointy grup odbiorców.