Choose a version:

cartDeliveryAddressesAdd

mutation

Adds delivery addresses to the cart.

Arguments

Anchor to addressesaddresses •[CartSelectableAddressInput!]! required: A list of delivery addresses to add to the cart.

The input must not contain more than 250 values.
Anchor to cartIdcartId •ID! required: The ID of the cart.

Was this section helpful?

Anchor to CartDeliveryAddressesAddPayload returnsCartDeliveryAddressesAddPayload 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?

Adds a delivery address to a cart
cartDeliveryAddressesAdd reference

Examples

Open in GraphiQL

const { storefront } = await unauthenticated.storefront(

'your-development-store.myshopify.com'

);

const response = await storefront.graphql(

`#graphql

mutation CartDeliveryAddressesAdd($id: ID!, $addresses: [CartSelectableAddressInput!]!) {

cartDeliveryAddressesAdd(cartId: $id, addresses: $addresses) {

userErrors {

message

code

field

}

warnings {

message

code

target

}

cart {

delivery {

addresses {

selected

oneTimeUse

address {

... on CartDeliveryAddress {

firstName

lastName

company

address1

address2

city

provinceCode

zip

countryCode

}

}`,

{

variables: {

"id": "gid://shopify/Cart/c1-145e58da76bbee55b288ea50b81810d3?key=0068c4788cbb29555c10c3acc3b2ffc2",

"addresses": [

{

"selected": true,

"address": {

"deliveryAddress": {

"address1": "131 Greene Street",

"city": "New York",

"provinceCode": "NY",

"countryCode": "US",

"zip": "10012"

}

]

);

const data = await response.json();

mutation CartDeliveryAddressesAdd($id: ID!, $addresses: [CartSelectableAddressInput!]!) {
  cartDeliveryAddressesAdd(cartId: $id, addresses: $addresses) {
    userErrors {
      message
      code
      field
    }
    warnings {
      message
      code
      target
    }
    cart {
      id
      delivery {
        addresses {
          id
          selected
          oneTimeUse
          address {
            ... on CartDeliveryAddress {
              firstName
              lastName
              company
              address1
              address2
              city
              provinceCode
              zip
              countryCode
            }
          }
        }
      }
    }
  }
}

curl -X POST \
https://your-development-store.myshopify.com/api/2025-04/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Storefront-Access-Token: {storefront_access_token}' \
-d '{
"query": "mutation CartDeliveryAddressesAdd($id: ID!, $addresses: [CartSelectableAddressInput!]!) { cartDeliveryAddressesAdd(cartId: $id, addresses: $addresses) { userErrors { message code field } warnings { message code target } cart { id delivery { addresses { id selected oneTimeUse address { ... on CartDeliveryAddress { firstName lastName company address1 address2 city provinceCode zip countryCode } } } } } } }",
 "variables": {
    "id": "gid://shopify/Cart/c1-145e58da76bbee55b288ea50b81810d3?key=0068c4788cbb29555c10c3acc3b2ffc2",
    "addresses": [
      {
        "selected": true,
        "address": {
          "deliveryAddress": {
            "address1": "131 Greene Street",
            "city": "New York",
            "provinceCode": "NY",
            "countryCode": "US",
            "zip": "10012"
          }
        }
      }
    ]
  }
}'

const { storefront } = await unauthenticated.storefront(
  'your-development-store.myshopify.com'
);

const response = await storefront.graphql(
  `#graphql
  mutation CartDeliveryAddressesAdd($id: ID!, $addresses: [CartSelectableAddressInput!]!) {
    cartDeliveryAddressesAdd(cartId: $id, addresses: $addresses) {
      userErrors {
        message
        code
        field
      }
      warnings {
        message
        code
        target
      }
      cart {
        id
        delivery {
          addresses {
            id
            selected
            oneTimeUse
            address {
              ... on CartDeliveryAddress {
                firstName
                lastName
                company
                address1
                address2
                city
                provinceCode
                zip
                countryCode
              }
            }
          }
        }
      }
    }
  }`,
  {
    variables: {
      "id": "gid://shopify/Cart/c1-145e58da76bbee55b288ea50b81810d3?key=0068c4788cbb29555c10c3acc3b2ffc2",
      "addresses": [
        {
          "selected": true,
          "address": {
            "deliveryAddress": {
              "address1": "131 Greene Street",
              "city": "New York",
              "provinceCode": "NY",
              "countryCode": "US",
              "zip": "10012"
            }
          }
        }
      ]
    },
  },
);

const data = await response.json();

const client = new shopify.clients.Storefront({
  domain: 'your-development-store.myshopify.com',
  storefrontAccessToken,
});
const data = await client.query({
  data: {
    "query": `mutation CartDeliveryAddressesAdd($id: ID!, $addresses: [CartSelectableAddressInput!]!) {
      cartDeliveryAddressesAdd(cartId: $id, addresses: $addresses) {
        userErrors {
          message
          code
          field
        }
        warnings {
          message
          code
          target
        }
        cart {
          id
          delivery {
            addresses {
              id
              selected
              oneTimeUse
              address {
                ... on CartDeliveryAddress {
                  firstName
                  lastName
                  company
                  address1
                  address2
                  city
                  provinceCode
                  zip
                  countryCode
                }
              }
            }
          }
        }
      }
    }`,
    "variables": {
      "id": "gid://shopify/Cart/c1-145e58da76bbee55b288ea50b81810d3?key=0068c4788cbb29555c10c3acc3b2ffc2",
      "addresses": [
        {
          "selected": true,
          "address": {
            "deliveryAddress": {
              "address1": "131 Greene Street",
              "city": "New York",
              "provinceCode": "NY",
              "countryCode": "US",
              "zip": "10012"
            }
          }
        }
      ]
    },
  },
});

Input variables

JSON

{

"id": "gid://shopify/Cart/c1-145e58da76bbee55b288ea50b81810d3?key=0068c4788cbb29555c10c3acc3b2ffc2",

"addresses": [

{

"selected": true,

"address": {

"deliveryAddress": {

"address1": "131 Greene Street",

"city": "New York",

"provinceCode": "NY",

"countryCode": "US",

"zip": "10012"

}

]

}

Response

JSON

{

"cartDeliveryAddressesAdd": {

"userErrors": [],

"warnings": [],

"cart": {

"id": "gid://shopify/Cart/c1-145e58da76bbee55b288ea50b81810d3?key=0068c4788cbb29555c10c3acc3b2ffc2",

"delivery": {

"addresses": [

{

"id": "gid://shopify/CartSelectableAddress/59168936-5627-4056-b460-9c2ca1dff094",

"selected": true,

"oneTimeUse": false,

"address": {

"firstName": null,

"lastName": "",

"company": null,

"address1": "131 Greene Street",

"address2": null,

"city": "New York",

"provinceCode": "NY",

"zip": "10012",

"countryCode": "US"

}

]

}