---
title: MailingAddressInput - Storefront API
description: >
  The input fields for creating or updating a
  [`MailingAddress`](/docs/api/storefront/2025-07/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/2025-07/mutations/customerAddressCreate)
  and
  [`customerAddressUpdate`](/docs/api/storefront/2025-07/mutations/customerAddressUpdate)
  mutations, and as part of
  [`DeliveryAddressInput`](/docs/api/storefront/2025-07/input-objects/DeliveryAddressInput)
  for cart delivery preferences.
api_version: 2025-07
api_name: storefront
type: input-object
api_type: graphql
source_url:
  html: >-
    https://shopify.dev/docs/api/storefront/2025-07/input-objects/MailingAddressInput
  md: >-
    https://shopify.dev/docs/api/storefront/2025-07/input-objects/MailingAddressInput.md
---

# Mailing​Address​Input

input\_object

The input fields for creating or updating a [`MailingAddress`](https://shopify.dev/docs/api/storefront/2025-07/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/2025-07/mutations/customerAddressCreate) and [`customerAddressUpdate`](https://shopify.dev/docs/api/storefront/2025-07/mutations/customerAddressUpdate) mutations, and as part of [`DeliveryAddressInput`](https://shopify.dev/docs/api/storefront/2025-07/input-objects/DeliveryAddressInput) for cart delivery preferences.

## Fields

* address1

  [String](https://shopify.dev/docs/api/storefront/2025-07/scalars/String)

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

* address2

  [String](https://shopify.dev/docs/api/storefront/2025-07/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/2025-07/scalars/String)

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

* company

  [String](https://shopify.dev/docs/api/storefront/2025-07/scalars/String)

  The name of the customer's company or organization.

* country

  [String](https://shopify.dev/docs/api/storefront/2025-07/scalars/String)

  The name of the country.

* first​Name

  [String](https://shopify.dev/docs/api/storefront/2025-07/scalars/String)

  The first name of the customer.

* last​Name

  [String](https://shopify.dev/docs/api/storefront/2025-07/scalars/String)

  The last name of the customer.

* phone

  [String](https://shopify.dev/docs/api/storefront/2025-07/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/2025-07/scalars/String)

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

* zip

  [String](https://shopify.dev/docs/api/storefront/2025-07/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/2025-07/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/2025-07/input-objects/DeliveryAddressInput#fields-deliveryAddress)