Contacts & CRM
updateContact
Update Contact
Update one of the caller's personal contacts by id.
Arguments
addressstringoptionalNew address.birthdaystringoptionalBirthday as a calendar date: "YYYY-MM-DD", or "--MM-DD" when the year is unknown (e.g. "--07-29" for July 29). Never shifts across timezones.contactIdstringrequiredThe contact id to update (from listContacts / resolveContact).emailstringoptionalNew email.iconDataobjectoptionalSet an emoji (or named lucide icon) as the contact's avatar.isArchivedbooleanoptionalSet true to archive, false to restore.jobTitlestringoptionalNew job title.linksobject[]optionalReplacement list of social links (replaces existing). Each is the platform/handle as a title + url, e.g. Telegram, Instagram, X, LinkedIn, WhatsApp.namestringoptionalNew name.notesstringoptionalNew notes.phonestringoptionalNew phone.propertiesobject[]optionalReplacement list of arbitrary custom key/value properties (replaces existing).stagestringoptionalMove the contact to this lifecycle stage (status).tagsstring[]optionalReplacement tag list (replaces existing tags).
Returns
Returns not-found if the contact is not the caller's.
Ask for it
The Cloud routes these requests to this verb.
- move Jane to customer
- add her Telegram link
- set a 🦊 avatar
- add a custom property
- archive this contact
Pair it with
The verbs that finish the job.