Create a saved filter
Create a saved AI Finder filter for later reuse. Filters are provider-aware and can be loaded directly into preview creation via savedFilterId.
Required scope:
ACTIONS_WRITERate limit: 30 requests per minute
Authorizations
Body
Name for the saved filter.
1Primary provider-specific search filters configuration to save. For LINKEDIN, send the field-keyed map directly (e.g. {"REGION": [...], "CURRENT_TITLE": [...]}) — do NOT wrap it in a top-level filtersByType key. A single filtersByType wrapper is auto-unwrapped for backward compatibility, but the unwrapped shape is required. For CRM_CONTACTS and CRM_COMPANIES, send the exact same {"include": {...}, "exclude": {...}} shape used by search_contacts_with_advanced_filters / search_companies_with_advanced_filters (e.g. {"include": {"icpScore": ["80", "100"]}, "exclude": {"companyGroup": [12]}}); CRM saved filters round-trip through that same advanced-search filter DSL.
Saved filter type (LEAD or COMPANY).
LEAD, COMPANY Which AI Finder provider this saved filter belongs to. Defaults to LINKEDIN for backward compatibility.
LINKEDIN, CRM_CONTACTS, CRM_COMPANIES, STORELEADS, CRUNCHBASE_COMPANIES, CRUNCHBASE_CONTACTS, CRUNCHBASE_INVESTORS, THEIRSTACK_TECHNOLOGY, THEIRSTACK_JOBS, GOOGLE_MAPS Optional keywords associated with this saved filter.
1Optional ordered fallback searches to try after the primary filter.
Whether the saved filter is shared with the team.