# CustomerSegmentMember - admin-graphql - OBJECT Version: 2025-01 ## Description The member of a segment. ### Access Scopes `read_customers` access scope. Also: The user must not have restricted access. ## Fields * [amountSpent](/docs/api/admin-graphql/2025-01/objects/MoneyV2): MoneyV2 - The total amount of money that the member has spent on orders. * [defaultAddress](/docs/api/admin-graphql/2025-01/objects/MailingAddress): MailingAddress - The member's default address. * [defaultEmailAddress](/docs/api/admin-graphql/2025-01/objects/CustomerEmailAddress): CustomerEmailAddress - The member's default email address. * [defaultPhoneNumber](/docs/api/admin-graphql/2025-01/objects/CustomerPhoneNumber): CustomerPhoneNumber - The member's default phone number. * [displayName](/docs/api/admin-graphql/2025-01/scalars/String): String! - The full name of the member, which is based on the values of the `first_name` and `last_name` fields. If the member's first name and last name aren't available, then the customer's email address is used. If the customer's email address isn't available, then the customer's phone number is used. * [firstName](/docs/api/admin-graphql/2025-01/scalars/String): String - The member's first name. * [id](/docs/api/admin-graphql/2025-01/scalars/ID): ID! - The member’s ID. * [lastName](/docs/api/admin-graphql/2025-01/scalars/String): String - The member's last name. * [lastOrderId](/docs/api/admin-graphql/2025-01/scalars/ID): ID - The ID of the member's most recent order. * [mergeable](/docs/api/admin-graphql/2025-01/objects/CustomerMergeable): CustomerMergeable! - Whether the customer can be merged with another customer. * [metafield](/docs/api/admin-graphql/2025-01/objects/Metafield): Metafield - A [custom field](https://shopify.dev/docs/apps/build/custom-data), including its `namespace` and `key`, that's associated with a Shopify resource for the purposes of adding and storing additional information. * [note](/docs/api/admin-graphql/2025-01/scalars/String): String - A note about the member. * [numberOfOrders](/docs/api/admin-graphql/2025-01/scalars/UnsignedInt64): UnsignedInt64 - The total number of orders that the member has made. ## Connections * [metafields](/docs/api/admin-graphql/2025-01/connections/MetafieldConnection): MetafieldConnection! ## Related queries * [customerSegmentMembers](/docs/api/admin-graphql/2025-01/queries/customerSegmentMembers) The list of members, such as customers, that's associated with an individual segment. The maximum page size is 1000. ## Related mutations ## Related Unions ## Examples ### Get the merge status of a customer segment member Curl example: "curl -X POST \\\nhttps://your-development-store.myshopify.com/admin/api/2025-01/graphql.json \\\n-H 'Content-Type: application/json' \\\n-H 'X-Shopify-Access-Token: {access_token}' \\\n-d '{\n\"query\": \"query { customerSegmentMembers(first: 1, query: \\\"\\\") { edges { node { mergeable { isMergeable reason errorFields mergeInProgress { jobId status resultingCustomerId customerMergeErrors { errorFields message } } } } } } }\"\n}'\n" Node example: "const client = new shopify.clients.Graphql({session});\nconst data = await client.query({\n data: `query {\n customerSegmentMembers(first: 1, query: \"\") {\n edges {\n node {\n mergeable {\n isMergeable\n reason\n errorFields\n mergeInProgress {\n jobId\n status\n resultingCustomerId\n customerMergeErrors {\n errorFields\n message\n }\n }\n }\n }\n }\n }\n }`,\n});\n" Ruby example: "session = ShopifyAPI::Auth::Session.new(\n shop: \"your-development-store.myshopify.com\",\n access_token: access_token\n)\nclient = ShopifyAPI::Clients::Graphql::Admin.new(\n session: session\n)\n\nquery = <<~QUERY\n query {\n customerSegmentMembers(first: 1, query: \"\") {\n edges {\n node {\n mergeable {\n isMergeable\n reason\n errorFields\n mergeInProgress {\n jobId\n status\n resultingCustomerId\n customerMergeErrors {\n errorFields\n message\n }\n }\n }\n }\n }\n }\n }\nQUERY\n\nresponse = client.query(query: query)\n" Remix example: "const { admin } = await authenticate.admin(request);\n\nconst response = await admin.graphql(\n `#graphql\n query {\n customerSegmentMembers(first: 1, query: \"\") {\n edges {\n node {\n mergeable {\n isMergeable\n reason\n errorFields\n mergeInProgress {\n jobId\n status\n resultingCustomerId\n customerMergeErrors {\n errorFields\n message\n }\n }\n }\n }\n }\n }\n }`,\n);\n\nconst data = await response.json();\n" Graphql query: "query {\n customerSegmentMembers(first: 1, query: \"\") {\n edges {\n node {\n mergeable {\n isMergeable\n reason\n errorFields\n mergeInProgress {\n jobId\n status\n resultingCustomerId\n customerMergeErrors {\n errorFields\n message\n }\n }\n }\n }\n }\n }\n}" #### Graphql Input null #### Graphql Response { "data": { "customerSegmentMembers": { "edges": [ { "node": { "mergeable": { "isMergeable": false, "reason": "Bob Bobsen is scheduled for redaction or has been redacted and can’t be merged.", "errorFields": [ "REDACTED_AT", "PENDING_DATA_REQUEST", "CUSTOMER_PAYMENT_METHODS", "COMPANY_CONTACT" ], "mergeInProgress": null } } } ] } } }