Migrate saved searches to customer segments

• Your app can make authenticated requests to the GraphQL Admin API.
• Your app has the read_customers and write_customers access scopes. Learn how to configure your access scopes using Shopify CLI.

Your app is affected if it uses any deprecated GraphQL Admin API types and fields or REST Admin API resources.

To determine whether your store is using customer saved searches, you can make a request to the GraphQL Admin API. The following example shows how to retrieve the first 250 customer saved searches:

If you're using the REST Admin API, then, you can use the GET customer_saved_searches endpoint to retrieve a list of customer saved searches for a store. The following example shows how to retrieve a list of customer saved searches:

This section describes deprecated GraphQL API types and fields and their replacements, changes to existing GraphQL Admin API types and fields, and recommended mutations for creating and modifying discount codes.

The following types were removed from the GraphQL Admin API:

• DiscountCustomerSavedSearches object
• DiscountCustomerSavedSearchesInput input object

Use the following elements instead:

• DiscountCustomerSegments object
• DiscountCustomerSegmentsInput input object

The following fields were removed from the GraphQL Admin API:

• savedSearches field from the PriceRuleCustomerSelection object
• savedSearchesIds field from the PriceRuleCustomerSelectionInput input object

Use the following fields instead:

• segments field from the PriceRuleCustomerSelection object
• segmentIds field from the PriceRuleCustomerSelectionInput input object

You can use the Discounts API to create and update discount codes for all customers or for specific customers. You can specify which customers can use which discount codes by using the GraphQL Admin API to filter out customers based on specific attributes.

The following mutations enable you to create or modify the following discount codes:

• DiscountCodeBxgyCreate
• DiscountCodeBxgyUpdate
• DiscountCodeFreeShippingCreate
• DiscountCodeFreeShippingUpdate
• discountCodeBasicCreate
• discountCodeBasicUpdate

The prerequisite_saved_search_ids property from the PriceRule resource in the REST Admin API is deprecated. Use the customer_segment_prerequisite_ids from the PriceRule resource instead.

The following table lists the resources that are affected by the REST Admin API saved searches deprecation:

The following types of saved searches are unmigratable if they create or update price rules or discount codes:

• Free text
• Saved searches that contain more than five filters

Unmigratable saved searches are blocked by the API validation and return an error. If an API request is blocked, then the price rule or discount code isn't affected.

If a saved search is updated, causing it to match the unmigratable saved search criteria, and that saved search is referenced by a price rule or a discount code, then the API request is blocked, and an error message is returned.

The following mutations are blocked if they use unmigratable saved searches:

• discountCodeBasicCreate
• discountCodeBasicUpdate
• discountCodeBxgyCreate
• discountCodeBxgyUpdate
• discountCodeFreeShippingCreate
• discountCodeFreeShippingUpdate
• priceRuleCreate
• priceRuleUpdate
• savedSearchUpdate

To determine which saved search corresponds to which segment, you can query SegmentMigrations. For example, use the segmentMigrations query to retrieve the segment ID that corresponds to a saved search ID.

The following example shows how to retrieve the first three segment migrations:

If you want your app to support segments, then you can change your app to use the queries and mutations that are described in the Manage customer segments guide.

• Learn how to manage customer segments.