Skip to main content
Permission: Write · Workspace: required (from goody_workspaces_list) Updates an existing contact. Only the fields you supply are written; omitted fields stay untouched. Returns the saved contact.

​
Parameters

​
workspace_id
string
required
Workspace UUID — from goody_workspaces_list. The contact must belong to this workspace.
​
contact_id
string
required
Contact UUID — from goody_contacts_search or goody_contacts_get.
​
first_name
string
Given name.
​
last_name
string
Family name.
​
email
string
Email address.
​
phone
string
Phone number in any format — it’s normalized automatically.
​
company
string
Company name.
​
title
string
Job title.
​
birthday
string
Date as YYYY-MM-DD; use year 1900 if only the month and day are known. Pass an empty string to clear it; omit it entirely to leave it unchanged.
​
work_anniversary
string
Date as YYYY-MM-DD. Pass an empty string to clear it; omit it entirely to leave it unchanged.
If the new email or phone already belongs to a different contact in this workspace, the request is rejected. Re-saving the contact’s own current email or phone is fine.

​
Returns

​
contact
object
The saved contact.

​
Example

"Update Maya's email to maya@northwind.io."

{
  "name": "goody_contacts_update",
  "arguments": {
    "workspace_id": "3f8a…",
    "contact_id": "9c44…",
    "email": "maya@northwind.io"
  }
}

{
  "contact": {
    "id": "9c44…",
    "first_name": "Maya",
    "last_name": "Patel",
    "email": "maya@northwind.io",
    "phone": "+14155550199",
    "company": "Northwind",
    "title": "Design Lead",
    "birthday": "1991-04-12",
    "work_anniversary": "2020-09-01"
  }
}
Find the contact first with goody_contacts_search, or read its current detail with goody_contacts_get.