--- title: Mutation - Storefront API description: The schema’s entry-point for mutations. This acts as the public, top-level API from which all mutation queries must start. api_version: 2025-01 api_name: storefront type: object api_type: graphql source_url: html: https://shopify.dev/docs/api/storefront/2025-01/objects/mutation md: https://shopify.dev/docs/api/storefront/2025-01/objects/mutation.md --- # Mutation object The schema’s entry-point for mutations. This acts as the public, top-level API from which all mutation queries must start. ## Fields * cart​Attributes​Update [Cart​Attributes​Update​Payload](https://shopify.dev/docs/api/storefront/2025-01/types/CartAttributesUpdatePayload) Updates the attributes on a cart. * cart​Buyer​Identity​Update [Cart​Buyer​Identity​Update​Payload](https://shopify.dev/docs/api/storefront/2025-01/types/CartBuyerIdentityUpdatePayload) Updates customer information associated with a cart. Buyer identity is used to determine [international pricing](https://shopify.dev/custom-storefronts/internationalization/international-pricing) and should match the customer's shipping address. * cart​Create [Cart​Create​Payload](https://shopify.dev/docs/api/storefront/2025-01/types/CartCreatePayload) Creates a new cart. * cart​Delivery​Addresses​Add [Cart​Delivery​Addresses​Add​Payload](https://shopify.dev/docs/api/storefront/2025-01/types/CartDeliveryAddressesAddPayload) Adds delivery addresses to the cart. * cart​Delivery​Addresses​Remove [Cart​Delivery​Addresses​Remove​Payload](https://shopify.dev/docs/api/storefront/2025-01/types/CartDeliveryAddressesRemovePayload) Removes delivery addresses from the cart. * cart​Delivery​Addresses​Update [Cart​Delivery​Addresses​Update​Payload](https://shopify.dev/docs/api/storefront/2025-01/types/CartDeliveryAddressesUpdatePayload) Updates one or more delivery addresses on a cart. * cart​Discount​Codes​Update [Cart​Discount​Codes​Update​Payload](https://shopify.dev/docs/api/storefront/2025-01/types/CartDiscountCodesUpdatePayload) Updates the discount codes applied to the cart. * cart​Gift​Card​Codes​Remove [Cart​Gift​Card​Codes​Remove​Payload](https://shopify.dev/docs/api/storefront/2025-01/types/CartGiftCardCodesRemovePayload) Removes the gift card codes applied to the cart. * cart​Gift​Card​Codes​Update [Cart​Gift​Card​Codes​Update​Payload](https://shopify.dev/docs/api/storefront/2025-01/types/CartGiftCardCodesUpdatePayload) Updates the gift card codes applied to the cart. * cart​Lines​Add [Cart​Lines​Add​Payload](https://shopify.dev/docs/api/storefront/2025-01/types/CartLinesAddPayload) Adds a merchandise line to the cart. * cart​Lines​Remove [Cart​Lines​Remove​Payload](https://shopify.dev/docs/api/storefront/2025-01/types/CartLinesRemovePayload) Removes one or more merchandise lines from the cart. * cart​Lines​Update [Cart​Lines​Update​Payload](https://shopify.dev/docs/api/storefront/2025-01/types/CartLinesUpdatePayload) Updates one or more merchandise lines on a cart. * cart​Metafield​Delete [Cart​Metafield​Delete​Payload](https://shopify.dev/docs/api/storefront/2025-01/types/CartMetafieldDeletePayload) Deletes a cart metafield. * cart​Metafields​Set [Cart​Metafields​Set​Payload](https://shopify.dev/docs/api/storefront/2025-01/types/CartMetafieldsSetPayload) Sets cart metafield values. Cart metafield values will be set regardless if they were previously created or not. Allows a maximum of 25 cart metafields to be set at a time. * cart​Note​Update [Cart​Note​Update​Payload](https://shopify.dev/docs/api/storefront/2025-01/types/CartNoteUpdatePayload) Updates the note on the cart. * cart​Selected​Delivery​Options​Update [Cart​Selected​Delivery​Options​Update​Payload](https://shopify.dev/docs/api/storefront/2025-01/types/CartSelectedDeliveryOptionsUpdatePayload) Update the selected delivery options for a delivery group. * customer​Access​Token​Create [Customer​Access​Token​Create​Payload](https://shopify.dev/docs/api/storefront/2025-01/types/CustomerAccessTokenCreatePayload) Creates a customer access token. The customer access token is required to modify the customer object in any way. * customer​Access​Token​Create​With​Multipass [Customer​Access​Token​Create​With​Multipass​Payload](https://shopify.dev/docs/api/storefront/2025-01/types/CustomerAccessTokenCreateWithMultipassPayload) Creates a customer access token using a [multipass token](https://shopify.dev/api/multipass) instead of email and password. A customer record is created if the customer doesn't exist. If a customer record already exists but the record is disabled, then the customer record is enabled. * customer​Access​Token​Delete [Customer​Access​Token​Delete​Payload](https://shopify.dev/docs/api/storefront/2025-01/types/CustomerAccessTokenDeletePayload) Permanently destroys a customer access token. * customer​Access​Token​Renew [Customer​Access​Token​Renew​Payload](https://shopify.dev/docs/api/storefront/2025-01/types/CustomerAccessTokenRenewPayload) Renews a customer access token. Access token renewal must happen *before* a token expires. If a token has already expired, a new one should be created instead via `customerAccessTokenCreate`. * customer​Activate [Customer​Activate​Payload](https://shopify.dev/docs/api/storefront/2025-01/types/CustomerActivatePayload) Activates a customer. * customer​Activate​By​Url [Customer​Activate​By​Url​Payload](https://shopify.dev/docs/api/storefront/2025-01/types/CustomerActivateByUrlPayload) Activates a customer with the activation url received from `customerCreate`. * customer​Address​Create [Customer​Address​Create​Payload](https://shopify.dev/docs/api/storefront/2025-01/types/CustomerAddressCreatePayload) Creates a new address for a customer. * customer​Address​Delete [Customer​Address​Delete​Payload](https://shopify.dev/docs/api/storefront/2025-01/types/CustomerAddressDeletePayload) Permanently deletes the address of an existing customer. * customer​Address​Update [Customer​Address​Update​Payload](https://shopify.dev/docs/api/storefront/2025-01/types/CustomerAddressUpdatePayload) Updates the address of an existing customer. * customer​Create [Customer​Create​Payload](https://shopify.dev/docs/api/storefront/2025-01/types/CustomerCreatePayload) Creates a new customer. * customer​Default​Address​Update [Customer​Default​Address​Update​Payload](https://shopify.dev/docs/api/storefront/2025-01/types/CustomerDefaultAddressUpdatePayload) Updates the default address of an existing customer. * customer​Recover [Customer​Recover​Payload](https://shopify.dev/docs/api/storefront/2025-01/types/CustomerRecoverPayload) Sends a reset password email to the customer. The reset password email contains a reset password URL and token that you can pass to the [`customerResetByUrl`](https://shopify.dev/api/storefront/latest/mutations/customerResetByUrl) or [`customerReset`](https://shopify.dev/api/storefront/latest/mutations/customerReset) mutation to reset the customer password. This mutation is throttled by IP. With private access, you can provide a [`Shopify-Storefront-Buyer-IP`](https://shopify.dev/api/usage/authentication#optional-ip-header) instead of the request IP. The header is case-sensitive and must be sent as `Shopify-Storefront-Buyer-IP`. Make sure that the value provided to `Shopify-Storefront-Buyer-IP` is trusted. Unthrottled access to this mutation presents a security risk. * customer​Reset [Customer​Reset​Payload](https://shopify.dev/docs/api/storefront/2025-01/types/CustomerResetPayload) "Resets a customer’s password with the token received from a reset password email. You can send a reset password email with the [`customerRecover`](https://shopify.dev/api/storefront/latest/mutations/customerRecover) mutation." * customer​Reset​By​Url [Customer​Reset​By​Url​Payload](https://shopify.dev/docs/api/storefront/2025-01/types/CustomerResetByUrlPayload) "Resets a customer’s password with the reset password URL received from a reset password email. You can send a reset password email with the [`customerRecover`](https://shopify.dev/api/storefront/latest/mutations/customerRecover) mutation." * customer​Update [Customer​Update​Payload](https://shopify.dev/docs/api/storefront/2025-01/types/CustomerUpdatePayload) Updates an existing customer. * shop​Pay​Payment​Request​Session​Create [Shop​Pay​Payment​Request​Session​Create​Payload](https://shopify.dev/docs/api/storefront/2025-01/types/ShopPayPaymentRequestSessionCreatePayload) Create a new Shop Pay payment request session. * shop​Pay​Payment​Request​Session​Submit [Shop​Pay​Payment​Request​Session​Submit​Payload](https://shopify.dev/docs/api/storefront/2025-01/types/ShopPayPaymentRequestSessionSubmitPayload) Submits a Shop Pay payment request session. *** ## Map No referencing types