Choose a version:

cartBuyerIdentityUpdate

mutation

Updates the buyer identity on a Cart, including contact information, location, and checkout preferences. The buyer's country determines international pricing and should match their shipping address.

Use this mutation to associate a logged-in customer via access token, set a B2B company location, or configure checkout preferences like delivery method. Preferences prefill checkout fields but don't sync back to the cart if overwritten at checkout.

Anchor to Arguments

Arguments

Anchor to buyerIdentitybuyerIdentity

•CartBuyerIdentityInput!

required

The customer associated with the cart. Used to determine international pricing. Buyer identity should match the customer's shipping address.

Anchor to cartIdcartId

•ID!

required

The ID of the cart.

Was this section helpful?

Anchor to CartBuyerIdentityUpdatePayload returnsCartBuyerIdentityUpdatePayload returns

Anchor to cartcart •Cart: The updated cart.
Anchor to userErrorsuserErrors •[CartUserError!]! non-null: The list of errors that occurred from executing the mutation.
Anchor to warningswarnings •[CartWarning!]! non-null: A list of warnings that occurred during the mutation.

Was this section helpful?

Examples

cartBuyerIdentityUpdate reference

Mutation Reference

mutation cartBuyerIdentityUpdate($cartId: ID!, $buyerIdentity: CartBuyerIdentityInput!) {

cartBuyerIdentityUpdate(cartId: $cartId, buyerIdentity: $buyerIdentity) {

cart {

# Cart fields

}

userErrors {

field

message

}

warnings {

# CartWarning fields

}

Input

{

"cartId": "gid://shopify/<objectName>/10079785100",

"buyerIdentity": {

"email": "<your-email>",

"phone": "<your-phone>",

"companyLocationId": "gid://shopify/<objectName>/10079785100",

"countryCode": "AF",

"customerAccessToken": "<your-customerAccessToken>",

"preferences": {

"delivery": {},

"wallet": [

"<your-wallet>"

]

}

Variables

{
  "cartId": "gid://shopify/<objectName>/10079785100",
  "buyerIdentity": {
    "email": "<your-email>",
    "phone": "<your-phone>",
    "companyLocationId": "gid://shopify/<objectName>/10079785100",
    "countryCode": "AF",
    "customerAccessToken": "<your-customerAccessToken>",
    "preferences": {
      "delivery": {},
      "wallet": [
        "<your-wallet>"
      ]
    }
  }
}

Schema

input CartBuyerIdentityInput {
  email: String
  phone: String
  companyLocationId: ID
  countryCode: CountryCode
  customerAccessToken: String
  preferences: CartPreferencesInput
}

input CartPreferencesInput {
  delivery: CartDeliveryPreferenceInput
  wallet: [String!]
}