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

string
required
Workspace UUID — from goody_workspaces_list. The contact is created in this workspace.
string
required
The contact’s given name.
string
Family name.
string
Email address.
string
Phone number in any format — it’s normalized automatically.
string
Company name.
string
Job title.
string
Date as YYYY-MM-DD. Use year 1900 if only the month and day are known.
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

object
The saved contact.

Example

To edit a contact you already have, use goody_contacts_update. To find one first, use goody_contacts_search.