Guardar um contacto
Faz o que Adicionar aos contactos e Manter nos contactos fazem na app, e é seguro seja qual for o estado do endereço. Um endereço que ainda não é contacto passa a sê-lo, com a resposta `201`. Um registado a partir de um envio passa a `manual`, e um já guardado mantém o que tem, com a resposta `200`. Um endereço eliminado é trazido de volta. O corpo é opcional.
Executa a chamada real contra o seu espaço de trabalho, com a sua própria chave.
PUT /contacts/{email}
Faz o que Adicionar aos contactos e Manter nos contactos fazem na app, e é seguro seja qual for o estado do endereço. Um endereço que ainda não é contacto passa a sê-lo, com a resposta 201. Um registado a partir de um envio passa a manual, e um já guardado mantém o que tem, com a resposta 200. Um endereço eliminado é trazido de volta. O corpo é opcional.
Exemplo
Requer contacts:write. Codifique o @ em URL.
curl -X PUT "$OE/contacts/grace%40example.com" -H "$AUTH" -H 'content-type: application/json' -d '{ "name": "Grace Hopper"}'{ "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 substitui o nome guardado e omiti-lo mantém-no. notes substitui as notas guardadas e null apaga-as. Qualquer outra chave é um 422 unknown_parameter.
Ao contrário de POST /contacts, um endereço que já está no livro não é um 409; ao contrário de PATCH, um endereço que não está no livro não é um 404. Um contacto novo entra na audiência predefinida.