---
title: Mutation - Customer API
description: This is the schema's entry point for all mutation operations.
api_version: 2025-10
api_name: customer
type: object
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/customer/latest/objects/mutation
  md: https://shopify.dev/docs/api/customer/latest/objects/mutation.md
---

# Mutation

object

This is the schema's entry point for all mutation operations.

## Fields

* company​Location​Assign​Address

  [Company​Location​Assign​Address​Payload](https://shopify.dev/docs/api/customer/latest/types/CompanyLocationAssignAddressPayload)

  Updates an address on a company location.

* customer​Address​Create

  [Customer​Address​Create​Payload](https://shopify.dev/docs/api/customer/latest/types/CustomerAddressCreatePayload)

  Creates a new address for a customer.

* customer​Address​Delete

  [Customer​Address​Delete​Payload](https://shopify.dev/docs/api/customer/latest/types/CustomerAddressDeletePayload)

  Deletes a specific address for a customer.

* customer​Address​Update

  [Customer​Address​Update​Payload](https://shopify.dev/docs/api/customer/latest/types/CustomerAddressUpdatePayload)

  Updates a specific address for a customer.

* customer​Email​Marketing​Subscribe

  [Customer​Email​Marketing​Subscribe​Payload](https://shopify.dev/docs/api/customer/latest/types/CustomerEmailMarketingSubscribePayload)

  Subscribes the customer to email marketing.

* customer​Email​Marketing​Unsubscribe

  [Customer​Email​Marketing​Unsubscribe​Payload](https://shopify.dev/docs/api/customer/latest/types/CustomerEmailMarketingUnsubscribePayload)

  Unsubscribes the customer from email marketing.

* customer​Update

  [Customer​Update​Payload](https://shopify.dev/docs/api/customer/latest/types/CustomerUpdatePayload)

  Updates the customer's personal information.

* metafields​Delete

  [Metafields​Delete​Payload](https://shopify.dev/docs/api/customer/latest/types/MetafieldsDeletePayload)

  Deletes multiple metafields in bulk.

* metafields​Set

  [Metafields​Set​Payload](https://shopify.dev/docs/api/customer/latest/types/MetafieldsSetPayload)

  Sets metafield values. Metafield values will be set regardless if they were previously created or not.

  Allows a maximum of 25 metafields to be set at a time.

  This operation is atomic, meaning no changes are persisted if an error is encountered.

  As of `2024-07`, this operation supports compare-and-set functionality to better handle concurrent requests. If `compareDigest` is set for any metafield, the mutation will only set that metafield if the persisted metafield value matches the digest used on `compareDigest`. If the metafield doesn't exist yet, but you want to guarantee that the operation will run in a safe manner, set `compareDigest` to `null`. The `compareDigest` value can be acquired by querying the metafield object and selecting `compareDigest` as a field. If the `compareDigest` value does not match the digest for the persisted value, the mutation will return an error. You can opt out of write guarantees by not sending `compareDigest` in the request.

* order​Request​Return

  [Order​Request​Return​Payload](https://shopify.dev/docs/api/customer/latest/types/OrderRequestReturnPayload)

  Request a new return on behalf of a customer.

* subscription​Billing​Cycle​Skip

  [Subscription​Billing​Cycle​Skip​Payload](https://shopify.dev/docs/api/customer/latest/types/SubscriptionBillingCycleSkipPayload)

  Skips a Subscription Billing Cycle.

* subscription​Billing​Cycle​Unskip

  [Subscription​Billing​Cycle​Unskip​Payload](https://shopify.dev/docs/api/customer/latest/types/SubscriptionBillingCycleUnskipPayload)

  Unskips a Subscription Billing Cycle.

* subscription​Contract​Activate

  [Subscription​Contract​Activate​Payload](https://shopify.dev/docs/api/customer/latest/types/SubscriptionContractActivatePayload)

  Activates a Subscription Contract. Contract status must be either active, paused, or failed.

* subscription​Contract​Cancel

  [Subscription​Contract​Cancel​Payload](https://shopify.dev/docs/api/customer/latest/types/SubscriptionContractCancelPayload)

  Cancels a Subscription Contract.

* subscription​Contract​Fetch​Delivery​Options

  [Subscription​Contract​Fetch​Delivery​Options​Payload](https://shopify.dev/docs/api/customer/latest/types/SubscriptionContractFetchDeliveryOptionsPayload)

  Fetches the available delivery options for a Subscription Contract.

* subscription​Contract​Pause

  [Subscription​Contract​Pause​Payload](https://shopify.dev/docs/api/customer/latest/types/SubscriptionContractPausePayload)

  Pauses a Subscription Contract.

* subscription​Contract​Select​Delivery​Method

  [Subscription​Contract​Select​Delivery​Method​Payload](https://shopify.dev/docs/api/customer/latest/types/SubscriptionContractSelectDeliveryMethodPayload)

  Selects an option from a delivery options result and updates the delivery method on a Subscription Contract.

* storefront​Customer​Access​Token​Create

  [Storefront​Customer​Access​Token​Create​Payload](https://shopify.dev/docs/api/customer/latest/types/StorefrontCustomerAccessTokenCreatePayload)

  Deprecated

***

## Map

No referencing types