--- title: "Create Saved Search" method: POST path: "/saved_searches" tags: ["saved_searches"] --- # Create Saved Search `POST /saved_searches` ## Request body - SavedSearchInput - `name` string, required - `is_private` boolean - `type` 'EVENT_FEED' | 'COMPANIES_LIST' | 'PERSONS' | 'TYPEAHEAD' | 'INVESTORS' - `query` ApiSearchQueryInput, required - `filter_group` FilterGroupInput, required - `join_operator` 'and' | 'or', required - `filters` Filter[], nullable - `field` string, required - `field_urn` string, nullable - `comparator` string, required - `filter_value` unknown - `filter_groups` FilterGroupInput[], nullable - `merge_nested_fields` boolean - `filter_group_generators` FilterGroupGenerator[], nullable - `generator_id` 'company_headcount' | 'search_v2_accelerator' | 'search_v2_company_funding_stage' | 'search_v2_company_funding_stage_simple' | 'search_v2_company_funding_total_range' | 'search_v2_company_funding_last_round_total_range' | 'search_v2_company_funding_undisclosed' | 'search_v2_company_currently_raising' | 'search_v2_company_funding_include_investors' | 'search_v2_company_funding_exclude_investors' | 'search_v2_company_funding_last_round_date' | 'search_v2_company_funding_foundation_date' | 'search_v2_company_funding_investors_deal_search' | 'search_v2_company_team_headcount_range' | 'search_v2_company_team_headcount_percent_growth_range' | 'search_v2_company_latest_web_traffic_range' | 'search_v2_company_web_traffic_percent_growth_range' | 'search_v2_company_headcount_department_percent_growth_range' | 'search_v2_company_socials_growth_range' | 'search_v2_company_team_highlights' | 'search_v2_company_sector_include_keywords' | 'search_v2_company_sector_exclude_keywords' | 'search_v2_company_sector_match_keywords' | 'search_v2_company_sector_include_industry_tags' | 'search_v2_company_sector_exclude_industry_tags' | 'search_v2_company_sector_include_business_tags' | 'search_v2_company_sector_exclude_business_tags' | 'search_v2_company_sector_include_technology_tags' | 'search_v2_company_sector_exclude_technology_tags' | 'search_v2_company_sector_preset' | 'search_v2_company_sector_include_tags' | 'search_v2_company_sector_exclude_tags' | 'search_v2_company_sector_product_categories' | 'search_v2_company_team_founding_experience' | 'search_v2_company_team_member_experience' | 'search_v2_company_team_notable_followers' | 'search_v2_company_team_notable_followers_count' | 'search_v2_company_list_and_more_initialized_date' | 'search_v2_company_list_and_more_updated_date' | 'search_v2_company_list_and_more_include_from_watchlist' | 'search_v2_company_list_and_more_exclude_from_watchlist' | 'search_v2_company_list_and_more_accelerators' | 'search_v2_company_list_and_more_location' | 'search_v2_company_list_and_more_continents' | 'search_v2_company_list_and_more_include_from_people_list' | 'search_v2_company_list_and_more_exclude_from_people_list' | 'search_v2_company_is_not_investor' | 'search_people_employees' | 'search_v2_people_education_experience' | 'search_v2_people_general_highlights' | 'search_v2_people_general_location' | 'search_v2_people_general_connections' | 'search_v2_people_general_linkedin_headlines' | 'search_v2_people_general_people_lists' | 'search_v2_people_current_experience' | 'search_v2_people_past_experience' | 'search_v2_people_general_correspondences' | 'search_v2_person_notable_followers' | 'search_v2_person_notable_followers_count' | 'search_v2_company_team_correspondences' | 'search_v2_semantic_search_filter' | 'search_v2_similar_company_search_filter' | 'search_v2_investor_aum_range' | 'search_v2_investor_check_size_range' | 'search_v2_investor_funded_company_location' | 'search_v2_investor_invested_stage' | 'search_v2_investor_latest_investment_date' | 'search_v2_investor_location' | 'search_v2_investor_num_deals_range' | 'search_v2_investor_team_size_range' | 'search_v2_investor_co_investors' | 'search_v2_investor_average_investment_size_range' | 'search_v2_investor_entry_stage_focus' | 'search_v2_investor_country_focus' | 'search_v2_investor_sector_focus' | 'search_v2_investor_funded_company' | 'search_v2_investor_website_keywords' | 'search_v2_investor_funded_company_sector_tags' | 'search_v2_investor_portfolio_details' | 'search_v2_investor_team_correspondences' | 'search_v2_investor_type' | 'search_v2_investor_primary_type' | 'search_v2_investor_secondary_types', required - `arguments` object, required - `pagination` Pagination, required - `start` integer, nullable - `page_size` integer, required - `sort` ServicesMidtierSchemasSavedSearchSort[] - `sort_field` string, required - `descending` boolean, required - `sort_context_values` SortContextArguments - `saved_search_id` integer, nullable - `date_added_after` string, nullable - `list_urn` union - string - string - `custom_field_urn` union - string - string - `company_id` integer, nullable — When sorting by `person_position_start_date`, scopes the sort to a single company so a person's unrelated active roles (board seats, prior jobs) don't skew their position in per-company employee lists. - `controlled_filter_group` FilterGroupInput - `join_operator` 'and' | 'or', required - `filters` Filter[], nullable - `field` string, required - `field_urn` string, nullable - `comparator` string, required - `filter_value` unknown - `filter_groups` FilterGroupInput[], nullable - `merge_nested_fields` boolean - `filter_group_generators` FilterGroupGenerator[], nullable - `generator_id` 'company_headcount' | 'search_v2_accelerator' | 'search_v2_company_funding_stage' | 'search_v2_company_funding_stage_simple' | 'search_v2_company_funding_total_range' | 'search_v2_company_funding_last_round_total_range' | 'search_v2_company_funding_undisclosed' | 'search_v2_company_currently_raising' | 'search_v2_company_funding_include_investors' | 'search_v2_company_funding_exclude_investors' | 'search_v2_company_funding_last_round_date' | 'search_v2_company_funding_foundation_date' | 'search_v2_company_funding_investors_deal_search' | 'search_v2_company_team_headcount_range' | 'search_v2_company_team_headcount_percent_growth_range' | 'search_v2_company_latest_web_traffic_range' | 'search_v2_company_web_traffic_percent_growth_range' | 'search_v2_company_headcount_department_percent_growth_range' | 'search_v2_company_socials_growth_range' | 'search_v2_company_team_highlights' | 'search_v2_company_sector_include_keywords' | 'search_v2_company_sector_exclude_keywords' | 'search_v2_company_sector_match_keywords' | 'search_v2_company_sector_include_industry_tags' | 'search_v2_company_sector_exclude_industry_tags' | 'search_v2_company_sector_include_business_tags' | 'search_v2_company_sector_exclude_business_tags' | 'search_v2_company_sector_include_technology_tags' | 'search_v2_company_sector_exclude_technology_tags' | 'search_v2_company_sector_preset' | 'search_v2_company_sector_include_tags' | 'search_v2_company_sector_exclude_tags' | 'search_v2_company_sector_product_categories' | 'search_v2_company_team_founding_experience' | 'search_v2_company_team_member_experience' | 'search_v2_company_team_notable_followers' | 'search_v2_company_team_notable_followers_count' | 'search_v2_company_list_and_more_initialized_date' | 'search_v2_company_list_and_more_updated_date' | 'search_v2_company_list_and_more_include_from_watchlist' | 'search_v2_company_list_and_more_exclude_from_watchlist' | 'search_v2_company_list_and_more_accelerators' | 'search_v2_company_list_and_more_location' | 'search_v2_company_list_and_more_continents' | 'search_v2_company_list_and_more_include_from_people_list' | 'search_v2_company_list_and_more_exclude_from_people_list' | 'search_v2_company_is_not_investor' | 'search_people_employees' | 'search_v2_people_education_experience' | 'search_v2_people_general_highlights' | 'search_v2_people_general_location' | 'search_v2_people_general_connections' | 'search_v2_people_general_linkedin_headlines' | 'search_v2_people_general_people_lists' | 'search_v2_people_current_experience' | 'search_v2_people_past_experience' | 'search_v2_people_general_correspondences' | 'search_v2_person_notable_followers' | 'search_v2_person_notable_followers_count' | 'search_v2_company_team_correspondences' | 'search_v2_semantic_search_filter' | 'search_v2_similar_company_search_filter' | 'search_v2_investor_aum_range' | 'search_v2_investor_check_size_range' | 'search_v2_investor_funded_company_location' | 'search_v2_investor_invested_stage' | 'search_v2_investor_latest_investment_date' | 'search_v2_investor_location' | 'search_v2_investor_num_deals_range' | 'search_v2_investor_team_size_range' | 'search_v2_investor_co_investors' | 'search_v2_investor_average_investment_size_range' | 'search_v2_investor_entry_stage_focus' | 'search_v2_investor_country_focus' | 'search_v2_investor_sector_focus' | 'search_v2_investor_funded_company' | 'search_v2_investor_website_keywords' | 'search_v2_investor_funded_company_sector_tags' | 'search_v2_investor_portfolio_details' | 'search_v2_investor_team_correspondences' | 'search_v2_investor_type' | 'search_v2_investor_primary_type' | 'search_v2_investor_secondary_types', required - `arguments` object, required - `merge_query_for_nested_fields` boolean - `keywords` string, required - `page` integer, nullable - `page_size` integer, nullable - `visible_columns` union[], nullable - union - string - string - string - string - string - string - `column_view_settings` SavedSearchColumnViewSettings[], nullable - `entity_urn` union, required - string - string - string - string - string - string - `column_width` integer, nullable ## Response `200` Successful Response - ResourceUrnResponseSavedSearchUrn - `urn` string, required - `metadata` DBOperationMetadata - `count_total` integer, nullable - `count_changed` integer, nullable - `count_skipped` integer, nullable - `count_not_found` integer, nullable ## Other responses - `422` — Validation Error --- [API](https://skmtc.net/harmonic/apis/harmonic-ai-public-api.md) · [All operations](https://skmtc.net/harmonic/apis/harmonic-ai-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/harmonic/harmonic-ai-public-api/versions/83a88f0a9b1c/schema)