---
title: CustomerInput - GraphQL Admin
description: The input fields and values to use when creating or updating a customer.
api_version: 2026-04
source_url:
  html: >-
    https://shopify.dev/docs/api/admin-graphql/latest/input-objects/CustomerInput
  md: >-
    https://shopify.dev/docs/api/admin-graphql/latest/input-objects/CustomerInput.md
api_name: admin
api_type: graphql
type: input-object
metadata:
  domain: admin
---

# Customer​Input

input\_object

The input fields and values to use when creating or updating a customer.

## Fields

* email

  [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

  The unique email address of the customer.

* email​Marketing​Consent

  [Customer​Email​Marketing​Consent​Input](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/CustomerEmailMarketingConsentInput)

  Information that describes when the customer consented to receiving marketing material by email. The `email` field is required when creating a customer with email marketing consent information.

* first​Name

  [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

  The customer's first name.

* id

  [ID](https://shopify.dev/docs/api/admin-graphql/latest/scalars/ID)

  The ID of the customer to update.

* last​Name

  [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

  The customer's last name.

* locale

  [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

  The customer's locale.

* metafields

  [\[Metafield​Input!\]](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/MetafieldInput)

  Additional metafields to associate to the customer.

* multipass​Identifier

  [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

  A unique identifier for the customer that's used with Multipass login.

* note

  [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

  A note about the customer.

* phone

  [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

  The unique phone number for the customer.

* sms​Marketing​Consent

  [Customer​Sms​Marketing​Consent​Input](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/CustomerSmsMarketingConsentInput)

  The marketing consent information when the customer consented to receiving marketing material by SMS. The `phone` field is required when creating a customer with SMS marketing consent information.

* tags

  [\[String!\]](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

  A list of tags to associate with the customer. Can be an array or a comma-separated list. Example values: `["tag1", "tag2", "tag3"]`, `"tag1, tag2, tag3"`

  Updating `tags` overwrites any existing tags that were previously added to the customer. To add new tags without overwriting existing tags, use the [tagsAdd](https://shopify.dev/api/admin-graphql/latest/mutations/tagsadd) mutation.

* tax​Exempt

  [Boolean](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Boolean)

  Whether the customer is exempt from paying taxes on their order.

* tax​Exemptions

  [\[Tax​Exemption!\]](https://shopify.dev/docs/api/admin-graphql/latest/enums/TaxExemption)

  The list of tax exemptions to apply to the customer.

* addresses

  [\[Mailing​Address​Input!\]](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/MailingAddressInput)

  Deprecated

***

## Mutations using this input

* [customer​Create.input](https://shopify.dev/docs/api/admin-graphql/latest/mutations/customerCreate#arguments-input)

  ARGUMENT

* [customer​Update.input](https://shopify.dev/docs/api/admin-graphql/latest/mutations/customerUpdate#arguments-input)

  ARGUMENT

***

## Map

### Mutations using this input

* [customer​Create.input](https://shopify.dev/docs/api/admin-graphql/latest/mutations/customerCreate#arguments-input)
* [customer​Update.input](https://shopify.dev/docs/api/admin-graphql/latest/mutations/customerUpdate#arguments-input)