---
title: MailingAddressInput - Storefront API
description: |
  The input fields for creating or updating a [`MailingAddress`](/docs/api/storefront/2026-01/objects/MailingAddress). Accepts standard address components including street address, city, province, country, and postal code, along with customer name and contact information.

  Used by the [`customerAddressCreate`](/docs/api/storefront/2026-01/mutations/customerAddressCreate) and [`customerAddressUpdate`](/docs/api/storefront/2026-01/mutations/customerAddressUpdate) mutations, and as part of [`DeliveryAddressInput`](/docs/api/storefront/2026-01/input-objects/DeliveryAddressInput) for cart delivery preferences.
api_version: 2026-01
api_name: storefront
type: input-object
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/storefront/latest/input-objects/mailingaddressinput
  md: https://shopify.dev/docs/api/storefront/latest/input-objects/mailingaddressinput.md
---

# Mailing​Address​Input

input\_object

The input fields for creating or updating a [`MailingAddress`](https://shopify.dev/docs/api/storefront/2026-01/objects/MailingAddress). Accepts standard address components including street address, city, province, country, and postal code, along with customer name and contact information.

Used by the [`customerAddressCreate`](https://shopify.dev/docs/api/storefront/2026-01/mutations/customerAddressCreate) and [`customerAddressUpdate`](https://shopify.dev/docs/api/storefront/2026-01/mutations/customerAddressUpdate) mutations, and as part of [`DeliveryAddressInput`](https://shopify.dev/docs/api/storefront/2026-01/input-objects/DeliveryAddressInput) for cart delivery preferences.

## Fields

* address1

  [String](https://shopify.dev/docs/api/storefront/latest/scalars/String)

  The first line of the address. Typically the street address or PO Box number.

* address2

  [String](https://shopify.dev/docs/api/storefront/latest/scalars/String)

  The second line of the address. Typically the number of the apartment, suite, or unit.

* city

  [String](https://shopify.dev/docs/api/storefront/latest/scalars/String)

  The name of the city, district, village, or town.

* company

  [String](https://shopify.dev/docs/api/storefront/latest/scalars/String)

  The name of the customer's company or organization.

* country

  [String](https://shopify.dev/docs/api/storefront/latest/scalars/String)

  The name of the country.

* first​Name

  [String](https://shopify.dev/docs/api/storefront/latest/scalars/String)

  The first name of the customer.

* last​Name

  [String](https://shopify.dev/docs/api/storefront/latest/scalars/String)

  The last name of the customer.

* phone

  [String](https://shopify.dev/docs/api/storefront/latest/scalars/String)

  A unique phone number for the customer.

  Formatted using E.164 standard. For example, *+16135551111*.

* province

  [String](https://shopify.dev/docs/api/storefront/latest/scalars/String)

  The region of the address, such as the province, state, or district.

* zip

  [String](https://shopify.dev/docs/api/storefront/latest/scalars/String)

  The zip or postal code of the address.

***

## Input objects using this input

* [Delivery​Address​Input.deliveryAddress](https://shopify.dev/docs/api/storefront/latest/input-objects/DeliveryAddressInput#fields-deliveryAddress)

  INPUT OBJECT

  The input fields for delivery address preferences.

***

## Map

### Input objects using this input

* [Delivery​Address​Input.deliveryAddress](https://shopify.dev/docs/api/storefront/latest/input-objects/DeliveryAddressInput#fields-deliveryAddress)