---
title: >-
  Unlink a customer's identity provider subject with the GraphQL Admin API -
  Shopify developer changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: >-
    https://shopify.dev/changelog/posts/unlink-a-customers-identity-provider-subject-with-the-admin-graphql-api
  md: >-
    https://shopify.dev/changelog/posts/unlink-a-customers-identity-provider-subject-with-the-admin-graphql-api.md
metadata:
  effectiveApiVersion: 2027-01
  affectedApi:
    - displayName: GraphQL Admin API
      handle: admin-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: New
    handle: new
  indicatesActionRequired: false
  createdAt: '2026-10-19T10:02:09-04:00'
  postedAt: '2026-10-23T09:00:00-04:00'
  updatedAt: '2026-10-22T16:06:39-04:00'
  effectiveAt: '2026-10-23T09:00:00-04:00'
---

October 23, 2026

# Unlink a customer's identity provider subject with the GraphQL Admin API

DateOctober 23, 2026

Version[2027-01](https://shopify.dev/changelog?api_version=2027-01)

FlagsNew

SurfacesAPI

Affected APIs[GraphQL Admin API](https://shopify.dev/changelog?api_type=admin-graphql)

As of API version 2027-01, you can use the [identityProviderSubjectDelete](https://shopify.dev/docs/api/admin-graphql/2027-01/mutations/identityProviderSubjectDelete) mutation to unlink a customer from a third-party identity provider.

Pass the customer's ID as `customerId` and the identity provider subject's ID as `id`. You can get subject IDs from [Customer.identityProviderSubjects](https://shopify.dev/docs/api/admin-graphql/2027-01/objects/Customer#field-identityProviderSubjects). Unlinking signs the customer out of all of their existing sessions. The next time they sign in through the identity provider, they're linked again.

The mutation requires the `write_customers` access scope.