> Agent-readable docs index: /llms.txt. Download /docs.zip to grep all markdown files locally.

---
title: "BuyerIdentityInput"
description: "The input fields to provide or update the buyer's identity and contact information. By supplying this information, the API can ensure accurate billing and shipping information for the buyer's order and facilitate personalized communication and support."
---

<Warning>
  Most of the fields in this object are optional. This allows for partial updates to Buyer Identity information when making calls to [`updateCartBuyerIdentity`](/api-reference/updatecartbuyeridentity) mutation. However, it's important to note that a complete and valid Buyer Identity is required when submitting the cart.
</Warning>

## Fields

<ParamField path="firstName" type="String">
  The first name of the buyer. This field can be used to personalize communications with the buyer and to identify the buyer in any customer support interactions.
</ParamField>

<ParamField path="lastName" type="String">
  The last name of the buyer. Similar to the `firstName` field, this field is used to personalize communications and identify the buyer in support interactions.
</ParamField>

<ParamField path="email" type="String">
  The email address of the buyer. This field is important for sending transactional emails, like order confirmations, shipping updates, or password resets.
</ParamField>

<ParamField path="phone" type="String">
  A 10-digit phone number, in [E.164](https://www.twilio.com/docs/glossary/what-e164) format.

  This field can be used for contacting the buyer in case of any issues with their order or for providing customer support.
</ParamField>

<ParamField path="address1" type="String">
  The first line of the buyer's address, which typically includes the street name and building number.
</ParamField>

<ParamField path="address2" type="String">
  The second line of the buyer's address, can include additional information like apartment or suite numbers.
</ParamField>

<ParamField path="city" type="String!">
  The name of the city, district, village, or town where the buyer is located.
</ParamField>

<ParamField path="provinceCode" type="String">
  The 2-3 letter province code which identifies the buyer's state or province, in ISO 3166-2 format.

  Example: `NY` for New York, `AUK` for Auckland.
</ParamField>

<ParamField path="countryCode" type={<a href="/api-reference/country">Country!</a>} required>
  Two letter ISO 3166-1 alpha-2 country code. Territories not explicitly defined in the [`Country`](/api-reference/country) enum are treated as subdivisions of their respective parent countries.

  Example: `US` for United States, or `NZ` for New Zealand.
</ParamField>

<ParamField path="postalCode" type="String">
  The area postal code or ZIP code, which is used for shipping and billing purposes.
</ParamField>

## Mutations

* [`createCart`](/api-reference/createcart)
* [`updateCartBuyerIdentity`](/api-reference/updatecartbuyeridentity)

## Related types

* [`CartBuyerIdentityUpdateInput`](/api-reference/cartbuyeridentityupdateinput)


---

*Powered by [holocron.so](https://holocron.so)*