---
title: SegmentMigration - GraphQL Admin
description: |-
  A segment and its corresponding saved search. 
  For example, you can use `SegmentMigration` to retrieve the segment ID that corresponds to a saved search ID.
api_version: 2025-10
api_name: admin
type: object
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/admin-graphql/latest/objects/segmentmigration
  md: https://shopify.dev/docs/api/admin-graphql/latest/objects/segmentmigration.md
---

# Segment​Migration

object

Requires `read_customers` access scope.

A segment and its corresponding saved search. For example, you can use `SegmentMigration` to retrieve the segment ID that corresponds to a saved search ID.

## Fields

* id

  [ID!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/ID)

  non-null

  A globally-unique ID.

* saved​Search​Id

  [ID!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/ID)

  non-null

  The ID of the saved search.

* segment​Id

  [ID](https://shopify.dev/docs/api/admin-graphql/latest/scalars/ID)

  The ID of the segment.

***

## Map

### Fields and connections with this object

* <->[SegmentMigrationConnection.nodes](https://shopify.dev/docs/api/admin-graphql/latest/connections/SegmentMigrationConnection#returns-nodes)
* {}[SegmentMigrationEdge.node](https://shopify.dev/docs/api/admin-graphql/latest/objects/SegmentMigrationEdge#field-SegmentMigrationEdge.fields.node)

***

## Queries

* [segment​Migrations](https://shopify.dev/docs/api/admin-graphql/latest/queries/segmentMigrations)

  query

  A list of a shop's segment migrations.

***

## \<?>SegmentMigration Queries

### Queried by

* \<?>[segment​Migrations](https://shopify.dev/docs/api/admin-graphql/latest/queries/segmentMigrations)