Skip to main content
Access: All users. See Access control.

list_saved_searches

List saved searches, or get a specific saved search by ID. When id is provided, returns that saved search with its filter values. Otherwise returns a table of all saved searches.

Arguments

integer | string
ID of a specific saved search to retrieve. Omit to list all.
string
Filter by search type (only used when listing). “contacts” or “companies”.One of: contacts, companies.

Result

Returns a text content block and a structuredContent object with these fields. Treat every field as nullable: a value the record does not have comes back as null.
object[]
Result records when listingFields vary by record.
object
Pagination metadata when available. Carries only the values the service has, so treat a missing key as unknown rather than zero; nextCursor is null or absent on the last page.
Save a set of search filters as a named saved search for later reuse. Returns the created saved search with its ID.

Arguments

string
required
Name for the saved search.
string
required
Search type: “contacts” or “companies”.One of: contacts, companies.
object
required
Search filter values to save (same filters used in search_contacts or search_companies).Fields vary by record.
string
Column to sort results by.
string
Sort order: “asc” or “desc”.
string[]
List IDs to associate with this saved search.
integer
default:"0"
Number of approved results for this saved search. Defaults to 0 (auto-calculated).

Result

Returns a text content block describing the outcome, plus a structuredContent object that mirrors it. This tool publishes no outputSchema, so the object’s fields are not guaranteed; treat every field as optional and nullable.

Example

Update an existing saved search name, filters, or sort options. Returns the updated saved search. When values is provided it replaces the saved filters wholesale rather than merging with the existing filters.
May overwrite, remove, or send data in a way that cannot be undone. Ask for explicit confirmation before calling this tool in an agent workflow.

Arguments

integer | string
required
ID of the saved search to update.
string
New name for the saved search.
object
Replacement search filter values, in the same form list_saved_searches returns them — read the saved search, change what you need, and send the values back. Replaces existing filters wholesale rather than merging. Omit to leave filters unchanged.Fields vary by record.
string
Column to sort results by.
string
Sort order: “asc” or “desc”.
string[]
List IDs to associate with this saved search.
integer
Number of approved results for this saved search.

Result

Returns a text content block describing the outcome, plus a structuredContent object that mirrors it. This tool publishes no outputSchema, so the object’s fields are not guaranteed; treat every field as optional and nullable. Permanently delete a saved search by its ID. This cannot be undone. Use list_saved_searches to find saved search IDs.
May overwrite, remove, or send data in a way that cannot be undone. Ask for explicit confirmation before calling this tool in an agent workflow.

Arguments

integer | string
required
ID of the saved search to delete.

Result

Returns a text content block describing the outcome, plus a structuredContent object that mirrors it. This tool publishes no outputSchema, so the object’s fields are not guaranteed; treat every field as optional and nullable.