search_people
Search for people in your workspace by name, job title, email address, or the organization they belong to. Use this tool when you need to find one or more contacts matching a text query.Parameters
string
required
The search string. Match against a person’s name, job title, email address, or organization name. Example:
"engineers at Acme" or "jane@example.com".number
Maximum number of results to return. Defaults to
10. Maximum value is 100.string
Filter results to people who belong to a specific organization. Use the organization’s
id field from a prior search_organizations or get_organization call.Returns
An array of person summary objects.Person[]
Example prompt
get_person
Retrieve the complete profile for a specific person by their unique ID. Use this tool after asearch_people call when you need fields that are not included in search results, such as phone number, LinkedIn URL, or timestamps.
Parameters
string
required
The unique ID of the person to retrieve. Obtain this from a
search_people or list_contacts result.Returns
A single full person object.Person
Example prompt
search_organizations
Search for organizations in your workspace by name or domain. Use this tool to find companies before looking up their members or passing anorganization_id to search_people.
Parameters
string
required
The search string. Matched against organization name and domain. Example:
"acme.com" or "healthcare".number
Maximum number of results to return. Defaults to
10. Maximum value is 100.Returns
An array of organization summary objects.Organization[]
Example prompt
get_organization
Retrieve full details for a specific organization by its ID. Optionally include its member list in the same response by settinginclude_members to true.
Parameters
string
required
The unique ID of the organization to retrieve. Obtain this from a
search_organizations result.boolean
When set to
true, the response includes a members array containing every person associated with the organization. Defaults to false.Returns
A single organization object. Wheninclude_members is true, the members array is populated.
Organization
Example prompt
list_contacts
List all contacts in your workspace with support for pagination and sorting. Use this tool when you want to browse or export your full contact list rather than search for a specific person.Parameters
number
Number of contacts to return per page. Defaults to
50. Maximum value is 200.number
Number of contacts to skip before returning results. Use together with
limit to paginate through large lists. Defaults to 0.string
Field to sort results by. Accepted values:
name— alphabetical by full namecreated_at— most recently added firstupdated_at— most recently modified first
Returns
A paginated response object.Person[]
Array of person objects for the current page. Each object contains the same fields returned by
search_people.number
Total number of contacts in your workspace, regardless of pagination. Use this with
limit and offset to calculate how many pages exist.