API

Een contact bijwerken

Een gedeeltelijke update, nooit een upsert. Een veld dat je weglaat behoudt zijn opgeslagen waarde en een expliciete `null` wist het, dus `{"notes": null}` leegt de notities terwijl `{}` niets verandert. Een adres dat niet in het adresboek staat levert een `404` op.

PATCHapi.openemail.uk/contacts/{email}

Voert de echte aanroep uit op je workspace, met je eigen sleutel.

PATCH /contacts/{email}

Een gedeeltelijke update, nooit een upsert. Een veld dat je weglaat behoudt zijn opgeslagen waarde en een expliciete null wist het, dus {"notes": null} leegt de notities terwijl {} niets verandert. Een adres dat niet in het adresboek staat levert een 404 op.

Voorbeeld

Vereist contacts:write. URL-encodeer de @.

curl

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

Antwoord

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

Het adres kan hier niet worden gewijzigd. Het is de identiteit, het padsegment en de unieke sleutel van het adresboek, dus een contact naar een nieuw adres verplaatsen is een verwijdering plus een aanmaak.

Een contact dat automatisch is vastgelegd blijft auto nadat je het een naam geeft. Het een naam geven is niet dezelfde bewering als dat iemand het heeft opgeslagen.

Audience-lidmaatschap blijft onaangeroerd. Gebruik daarvoor de audience-routes.