Skip to main content
Permission: Write · Workspace: required (from goody_workspaces_list) Creates a contact in the workspace. Only first_name is required; everything else is optional. Returns the saved contact.

​
Parameters

​
workspace_id
string
required
Workspace UUID — from goody_workspaces_list. The contact is created in this workspace.
​
first_name
string
required
The contact’s 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.
​
work_anniversary
string
Date as YYYY-MM-DD. Use year 1900 if only the month and day are known.
If a contact with the same email or phone already exists in this workspace, the request is rejected rather than overwriting the existing contact. Call goody_contacts_update to modify that contact instead.

​
Returns

​
contact
object
The saved contact.

​
Example

"Add James Okafor (james@northwind.com) to my workspace."

{
  "name": "goody_contacts_create",
  "arguments": {
    "workspace_id": "3f8a…",
    "first_name": "James",
    "last_name": "Okafor",
    "email": "james@northwind.com"
  }
}

{
  "contact": {
    "id": "a1d7…",
    "first_name": "James",
    "last_name": "Okafor",
    "email": "james@northwind.com",
    "phone": null,
    "company": null,
    "title": null,
    "birthday": null,
    "work_anniversary": null
  }
}
To edit a contact you already have, use goody_contacts_update. To find one first, use goody_contacts_search.