Enregistrer un contact
Fait ce que font Ajouter aux contacts et Garder dans les contacts dans l'application, et reste sûr quel que soit l'état de l'adresse. Une adresse qui n'est pas encore un contact en devient un, avec la réponse `201`. Une adresse relevée lors d'un envoi devient `manual`, et une adresse déjà enregistrée garde ce qu'elle a, avec la réponse `200`. Une adresse supprimée est ramenée. Le corps est facultatif.
Exécute le véritable appel sur votre espace de travail, avec votre propre clé.
PUT /contacts/{email}
Fait ce que font Ajouter aux contacts et Garder dans les contacts dans l'application, et reste sûr quel que soit l'état de l'adresse. Une adresse qui n'est pas encore un contact en devient un, avec la réponse 201. Une adresse relevée lors d'un envoi devient manual, et une adresse déjà enregistrée garde ce qu'elle a, avec la réponse 200. Une adresse supprimée est ramenée. Le corps est facultatif.
Exemple
Nécessite contacts:write. Encodez le @ dans l'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 remplace le nom enregistré, et l'omettre le conserve. notes remplace les notes enregistrées, et null les efface. Toute autre clé donne un 422 unknown_parameter.
Contrairement à POST /contacts, une adresse déjà dans le carnet ne donne pas de 409 ; contrairement à PATCH, une adresse absente du carnet ne donne pas de 404. Un nouveau contact rejoint l'audience par défaut.