customerCreate mutation

Creates a new customer.

Required access

write_customers access scope.

On this page

• Interactive example
• Arguments
• CustomerInput fields
• Return fields

Interactive example

This is an example mutation query. Use the embedded interactive tool below to edit the query.

Hint: use Ctrl + Space for autocompleting fields.

<font style="color:#1F61A0;">customer</font> <font style="color:#555555;">{</font>
  <font style="color:#1F61A0;">id</font>
<font style="color:#555555;">}</font>
<font style="color:#1F61A0;">userErrors</font> <font style="color:#555555;">{</font>
  <font style="color:#1F61A0;">field</font>
  <font style="color:#1F61A0;">message</font>
<font style="color:#555555;">}</font>

Arguments

CustomerInput fields

• acceptsMarketing ([Boolean](https://shopify.dev/docs/admin-api/graphql/reference/scalar#boolean-2021-01))
  Whether the customer has consented to receive marketing material via email.
• acceptsMarketingUpdatedAt ([DateTime](https://shopify.dev/docs/admin-api/graphql/reference/scalar#datetime-2021-01))
  The date and time when the customer consented or objected to receiving marketing material by email. Set whenever the customer consents or objects to marketing material.
• addresses ([[MailingAddressInput!]](https://shopify.dev/docs/admin-api/graphql/reference/common-objects/mailingaddressinput))
  An input that specifies addresses for a customer.
• email ([String](https://shopify.dev/docs/admin-api/graphql/reference/scalar#string-2021-01))
  The unique email address of the customer.
• firstName ([String](https://shopify.dev/docs/admin-api/graphql/reference/scalar#string-2021-01))
  The customer’s first name.
• id ([ID](https://shopify.dev/docs/admin-api/graphql/reference/scalar#id-2021-01))
  Specifies the customer to update, or creates a new customer if one doesn’t exist.
• lastName ([String](https://shopify.dev/docs/admin-api/graphql/reference/scalar#string-2021-01))
  The customer’s last name.
• locale ([String](https://shopify.dev/docs/admin-api/graphql/reference/scalar#string-2021-01))
  The customer’s locale.
• marketingOptInLevel ([CustomerMarketingOptInLevel](https://shopify.dev/docs/admin-api/graphql/reference/customers/customermarketingoptinlevel))
  The marketing subscription opt-in level (as described by the M3AAWG best practices guideline) that was enabled when the customer consented to receiving marketing material by email.
• metafields ([[MetafieldInput!]](https://shopify.dev/docs/admin-api/graphql/reference/metafields/metafieldinput))
  Attaches additional metadata to the customer.
• note ([String](https://shopify.dev/docs/admin-api/graphql/reference/scalar#string-2021-01))
  A note about the customer.
• phone ([String](https://shopify.dev/docs/admin-api/graphql/reference/scalar#string-2021-01))
  The unique phone number for the customer.
• privateMetafields ([[PrivateMetafieldInput!]](https://shopify.dev/docs/admin-api/graphql/reference/metafields/privatemetafieldinput))
  The private metafields to associated with this product.
• tags ([[String!]](https://shopify.dev/docs/admin-api/graphql/reference/scalar#string-2021-01))
  A comma separated list of tags associated with the customer. Updating tags overwrites any existing tags that were previously added to the customer. To add new tags without overwriting existing tags, use the tagsAdd mutation.
• taxExempt ([Boolean](https://shopify.dev/docs/admin-api/graphql/reference/scalar#boolean-2021-01))
  Whether the customer is exempt from paying taxes on their order.
• taxExemptions ([[TaxExemption!]](https://shopify.dev/docs/admin-api/graphql/reference/customers/taxexemption))
  The list of tax exemptions to apply to the customer.

Return fields

• customer ([Customer](https://shopify.dev/docs/admin-api/graphql/reference/customers/customer))
  The created customer.
• userErrors ([[UserError!]!](https://shopify.dev/docs/admin-api/graphql/reference/usererror))
  List of errors that occurred executing the mutation.