Seeking clarification on "Request segments query" and "customerSegmentMembers" requirements

Technical Q&A

Topic summary

Clearing Shopify Partner Dashboard flags for customer segmentation API usage remains unresolved. The app issues GraphQL calls to list segments and fetch segment members, but the dashboard still shows both activity flags as unmet.

Clarifications requested:

  • If a specific API version is required for activity to register.
  • If development store calls count or a production (live) install is needed.
  • If specific scopes for customer segmentation must be enabled for the activity to count.

Community guidance (experience-based):

  • Use the latest stable API version (e.g., 2024-10) to ensure calls are recognized.
  • Development store activity typically counts, but some flags may only update after use on a live/production store.
  • Verify correct customer segmentation read permissions; returning data alone may not trigger the flags. Test on a live store to confirm.

Outcome: No official confirmation from Shopify. Next steps are to verify scopes and API version and to test on a production store; the thread remains open.

Summarized with AI on December 18. AI used: gpt-5.
1

Hello everyone,

I am working on ensuring my app meets the latest Shopify API requirements regarding customer segmentation. Specifically, I am trying to resolve the following two dashboard flags:

  1. Request segments query in the last 30 days

  2. Has queried customerSegmentMembers in the last 30 days

I have implemented the following GraphQL queries in my application code to address these, but the flags remain “unmet.”

**Query 1: Fetching Segments
**
query GetCustomerSegments {
segments(first: 10) {
edges {
node {
id
name
query
}
}
}
}

**Query 2: Fetching Members for a specific segment
**
query GetSegmentMembers {
customerSegmentMembers(first: 5, segmentId: “gid://shopify/Segment/598845063465”) {
edges {
node {
id
defaultEmailAddress {
emailAddress
}
}
}
}
}

My Questions:

  1. Is there a specific API Version (e.g., 2024-01 or 2024-04) required for these to be registered as “active” in the partner dashboard?

  2. Does the query need to be triggered by a production store install, or do Development Store queries count toward clearing these flags?

  3. Are there specific scopes (like read_customer_segmentation) that must be explicitly active for these queries to “count,” even if the query technically returns data?

Any guidance from the community or the Shopify team would be greatly appreciated. Thank you!

2

Hey @lovedeep.webgarh,

Thanks for sharing the details. From my experience:

  1. The API version does matter, using the latest stable version (e.g., 2024-10) ensures your queries are recognised in the partner Dashboard.
  2. Queries from a Development store typically do count, but some flags may only register after a products store install.
  3. Make sure the app has the proper scopes, especially read_customer_segments (or equivalent), as returning data along isn’t always enough for the dashboard to mark the flag as “met“.

I’d recommend verifying the scope permissions and testing the queries on a live store to confirm the flags update.

Hope this helps.

4

image
image886×101 7.31 KB
I

I have these two scopes and graphql queries are working fine. There is no mentioned of “read_customer_segments“ in docs.