API

連絡先を更新する

部分更新であり、upsert ではありません。省略したフィールドは保存されている値を保ち、明示的な `null` は値をクリアします。つまり `{"notes": null}` はメモを空にし、`{}` は何も変えません。アドレス帳にないアドレスは `404` です。

PATCHapi.openemail.uk/contacts/{email}

実際の呼び出しを、ご自身のキーで自分のワークスペースに対して実行します。

PATCH /contacts/{email}

部分更新であり、upsert ではありません。省略したフィールドは保存されている値を保ち、明示的な null は値をクリアします。つまり {"notes": null} はメモを空にし、{} は何も変えません。アドレス帳にないアドレスは 404 です。

例

contacts:write が必要です。@ は URL エンコードしてください。

curl

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

レスポンス

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

ここではアドレスを変更できません。アドレスは識別子であり、パスセグメントであり、アドレス帳の一意キーでもあるため、連絡先を別のアドレスに移すことは削除と作成になります。

自動で記録された連絡先は、名前を付けても auto のままです。名前を付けることは、誰かが保存したという主張と同じではありません。

オーディエンスのメンバーシップには手を触れません。それにはオーディエンスのルートを使ってください。