# CustomerInput - admin-graphql - INPUT_OBJECT Version: 2024-10 ## Description The input fields and values to use when creating or updating a customer. ### Access Scopes ## Fields * [addresses](/docs/api/admin-graphql/2024-10/input-objects/MailingAddressInput): MailingAddressInput - The addresses for a customer. * [email](/docs/api/admin-graphql/2024-10/scalars/String): String - The unique email address of the customer. * [emailMarketingConsent](/docs/api/admin-graphql/2024-10/input-objects/CustomerEmailMarketingConsentInput): 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. * [firstName](/docs/api/admin-graphql/2024-10/scalars/String): String - The customer's first name. * [id](/docs/api/admin-graphql/2024-10/scalars/ID): ID - The ID of the customer to update. * [lastName](/docs/api/admin-graphql/2024-10/scalars/String): String - The customer's last name. * [locale](/docs/api/admin-graphql/2024-10/scalars/String): String - The customer's locale. * [metafields](/docs/api/admin-graphql/2024-10/input-objects/MetafieldInput): MetafieldInput - Additional metafields to associate to the customer. * [note](/docs/api/admin-graphql/2024-10/scalars/String): String - A note about the customer. * [phone](/docs/api/admin-graphql/2024-10/scalars/String): String - The unique phone number for the customer. * [privateMetafields](/docs/api/admin-graphql/2024-10/input-objects/PrivateMetafieldInput): PrivateMetafieldInput - The private metafields to associate with the customer. * [smsMarketingConsent](/docs/api/admin-graphql/2024-10/input-objects/CustomerSmsMarketingConsentInput): 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](/docs/api/admin-graphql/2024-10/scalars/String): 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. * [taxExempt](/docs/api/admin-graphql/2024-10/scalars/Boolean): Boolean - Whether the customer is exempt from paying taxes on their order. * [taxExemptions](/docs/api/admin-graphql/2024-10/enums/TaxExemption): TaxExemption - The list of tax exemptions to apply to the customer. ## Input objects with this input object * [customerCreate](/docs/api/admin-graphql/2024-10/mutations/customerCreate) * [customerUpdate](/docs/api/admin-graphql/2024-10/mutations/customerUpdate) ## Examples