Skip to main content
Permission: Write · Workspace: required (from goody_workspaces_list) Creates a new active contact list in the workspace, optionally seeded with members. Use the returned id with goody_autogift_rules_create.

​
Parameters

​
workspace_id
string
required
Workspace UUID — from goody_workspaces_list. The list is created in this workspace.
​
name
string
required
The visible list name (e.g. “Q3 onboarding cohort”).
​
contact_ids
string[]
Optional initial members — contact UUIDs from goody_contacts_search or goody_contacts_get. Contacts that aren’t in this workspace are silently skipped.

​
Returns

​
contact_list
object
The created list.

​
Example

"Make an 'Onboarding' list with these three contacts."

{
  "name": "goody_contact_lists_create",
  "arguments": {
    "workspace_id": "3f8a…",
    "name": "Onboarding",
    "contact_ids": ["7b21…", "9c44…", "a1d7…"]
  }
}

{
  "contact_list": {
    "id": "d052…",
    "name": "Onboarding",
    "contact_count": 3
  }
}
Find members first with goody_contacts_search, then point an goody_autogift_rules_create rule at the new list.