What arguments does updateCustomerAddressV2 accept?

The updateCustomerAddressV2 mutation accepts 2 arguments: uid (ID!), required; input (CustomerAddressInput).

What does updateCustomerAddressV2 return?

updateCustomerAddressV2 returns CustomerAddress.

Does updateCustomerAddressV2 require authentication?

updateCustomerAddressV2 requires an Authorization header with a Bearer customer token. Obtain the token by calling the generateCustomerToken mutation with the customer's email and password.

MageSmith

MutationCustomer · Magento 2.4.9

updateCustomerAddressV2

Q: What does the updateCustomerAddressV2 mutation do in Magento 2 GraphQL?

updateCustomerAddressV2 is a Magento 2 GraphQL mutation in the Customer module. Update the billing or shipping address of a customer or guest. It returns CustomerAddress and requires an Authorization header (Bearer customer token).

updateCustomerAddressV2 is a Magento 2 GraphQL mutation in the Customer module. Update the billing or shipping address of a customer or guest. It returns CustomerAddress and requires an Authorization header (Bearer customer token).

Last verified: 2026-05-23 against Magento 2.4.9.

Returns

CustomerAddress

Resolver class

Magento\CustomerGraphQl\Model\Resolver\UpdateCustomerAddressV2

Arguments

uid ID! Required

The unique ID of the customer address.

input CustomerAddressInput

An input object that contains changes to the customer address.

Example request

Auto-generated from the SDL — paste-ready against your store's /graphql endpoint. Replace the host, store code, and any required values before running.

Headers

Content-Type

application/json

Store

default store view code; use 'default' for the single-store baseline

Authorization

Bearer <CUSTOMER_TOKEN> obtain from generateCustomerToken mutation

Query

mutation ($uid: ID!) {
  updateCustomerAddressV2(uid: $uid) {
    id
    uid
    customer_id
    region {
      region_code
      region
      region_id
    }
    region_id
    country_id
    country_code
    street
    company
    telephone
    fax
    postcode
    city
    firstname
    lastname
    middlename
    prefix
    suffix
    vat_id
    default_shipping
    default_billing
    custom_attributes {
      attribute_code
      value
    }
    custom_attributesV2 {
      code
    }
    extension_attributes {
      attribute_code
      value
    }
  }
}