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."
Find members first with goody_contacts_search, then point an goody_autogift_rules_create rule at the new list.