Read · Workspace: required (from goody_workspaces_list)
Searches the contacts in a workspace and returns up to limit matches. Use it to find a recipient before pricing or sending a gift. Match a free-text query across name, email, and phone — or omit it to list everyone alphabetically.
Parameters
string
required
Workspace UUID — from
goody_workspaces_list. Search is always scoped to this workspace.string
Free-text search matched across first name, last name, email, and phone. Name matches outrank email matches, which outrank phone matches. Omit to list contacts alphabetically.
integer
default:"25"
Maximum contacts to return. Range 1–25; higher values are clamped to 25. There’s no pagination — narrow
query instead of raising the limit.Returns
object[]
Up to
limit matching contacts.The search response omits event dates. To get a contact’s birthday or work anniversary, call
goody_contacts_get.