---
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: unstable
api_name: admin
source_url:
  html: 'https://shopify.dev/docs/api/admin-graphql/unstable/objects/SegmentMigration'
  md: >-
    https://shopify.dev/docs/api/admin-graphql/unstable/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/unstable/scalars/ID)

  non-null

  A globally-unique ID.

* saved​Search​Id

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

  non-null

  The ID of the saved search.

* segment​Id

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

  The ID of the segment.

***

## Map

### Fields and connections with this object

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

***

## Queries

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

  query

  A list of a shop's segment migrations.

***

## \<?>SegmentMigration Queries

### Queried by

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