Skip to main content
object

Represents an error in the input of a mutation.

•[String!]

The path to the input field that caused the error.

•String!non-null

The error message.


Was this section helpful?

•mutation

Creates a customer access token. The customer access token is required to modify the customer object in any way.

Arguments

•CustomerAccessTokenCreateInput!required

The fields used to create a customer access token.


Fields

•CustomerAccessToken

The newly created customer access token object.

•[CustomerUserError!]!non-null

The list of errors that occurred from executing the mutation.

•[UserError!]!non-nullDeprecated
•mutation

Permanently destroys a customer access token.

Arguments

•String!required

The access token used to identify the customer.


Fields

•String

The destroyed access token.

Anchor to deletedCustomerAccessTokenIddeletedCustomerAccessTokenId
•String

ID of the destroyed customer access token.

•[UserError!]!non-null

The list of errors that occurred from executing the mutation.

•mutation

Renews a customer access token.

Access token renewal must happen before a token expires. If a token has already expired, a new one should be created instead via customerAccessTokenCreate.

Arguments

•String!required

The access token used to identify the customer.


Fields

•CustomerAccessToken

The renewed customer access token object.

•[UserError!]!non-null

The list of errors that occurred from executing the mutation.

•mutation

Activates a customer.

Arguments

•ID!required

Specifies the customer to activate.

•CustomerActivateInput!required

The fields used to activate a customer.


Fields

•Customer

The customer object.

•CustomerAccessToken

A newly created customer access token object for the customer.

•[CustomerUserError!]!non-null

The list of errors that occurred from executing the mutation.

•[UserError!]!non-nullDeprecated
•mutation

Creates a new address for a customer.

Arguments

•MailingAddressInput!required

The customer mailing address to create.

•String!required

The access token used to identify the customer.


Fields

•MailingAddress

The new customer address object.

•[CustomerUserError!]!non-null

The list of errors that occurred from executing the mutation.

•[UserError!]!non-nullDeprecated
•mutation

Permanently deletes the address of an existing customer.

Arguments

•String!required

The access token used to identify the customer.

•ID!required

Specifies the address to delete.


Fields

•[CustomerUserError!]!non-null

The list of errors that occurred from executing the mutation.

Anchor to deletedCustomerAddressIddeletedCustomerAddressId
•String

ID of the deleted customer address.

•[UserError!]!non-nullDeprecated
•mutation

Updates the address of an existing customer.

Arguments

•MailingAddressInput!required

The customer’s mailing address.

•String!required

The access token used to identify the customer.

•ID!required

Specifies the customer address to update.


Fields

•MailingAddress

The customer’s updated mailing address.

•[CustomerUserError!]!non-null

The list of errors that occurred from executing the mutation.

•[UserError!]!non-nullDeprecated
•mutation

Creates a new customer.

Arguments

•CustomerCreateInput!required

The fields used to create a new customer.


Fields

•Customer

The created customer object.

•[CustomerUserError!]!non-null

The list of errors that occurred from executing the mutation.

•[UserError!]!non-nullDeprecated
•mutation

Updates the default address of an existing customer.

Arguments

•ID!required

ID of the address to set as the new default for the customer.

•String!required

The access token used to identify the customer.


Fields

•Customer

The updated customer object.

•[CustomerUserError!]!non-null

The list of errors that occurred from executing the mutation.

•[UserError!]!non-nullDeprecated
•mutation

Sends a reset password email to the customer. The reset password email contains a reset password URL and token that you can pass to the customerResetByUrl or customerReset mutation to reset the customer password.

This mutation is throttled by IP. With private access, you can provide a Shopify-Storefront-Buyer-IP instead of the request IP. The header is case-sensitive and must be sent as Shopify-Storefront-Buyer-IP.

Make sure that the value provided to Shopify-Storefront-Buyer-IP is trusted. Unthrottled access to this mutation presents a security risk.

Arguments

•String!required

The email address of the customer to recover.


Fields

•[CustomerUserError!]!non-null

The list of errors that occurred from executing the mutation.

•[UserError!]!non-nullDeprecated
•mutation

"Resets a customer’s password with the token received from a reset password email. You can send a reset password email with the customerRecover mutation."

Arguments

•ID!required

Specifies the customer to reset.

•CustomerResetInput!required

The fields used to reset a customer’s password.


Fields

•Customer

The customer object which was reset.

•CustomerAccessToken

A newly created customer access token object for the customer.

•[CustomerUserError!]!non-null

The list of errors that occurred from executing the mutation.

•[UserError!]!non-nullDeprecated
•mutation

"Resets a customer’s password with the reset password URL received from a reset password email. You can send a reset password email with the customerRecover mutation."

Arguments

•String!required

New password that will be set as part of the reset password process.

•URL!required

The customer's reset password url.


Fields

•Customer

The customer object which was reset.

•CustomerAccessToken

A newly created customer access token object for the customer.

•[CustomerUserError!]!non-null

The list of errors that occurred from executing the mutation.

•[UserError!]!non-nullDeprecated
•mutation

Updates an existing customer.

Arguments

•CustomerUpdateInput!required

The customer object input.

•String!required

The access token used to identify the customer.


Fields

•Customer

The updated customer object.

•CustomerAccessToken

The newly created customer access token. If the customer's password is updated, all previous access tokens (including the one used to perform this mutation) become invalid, and a new token is generated.

•[CustomerUserError!]!non-null

The list of errors that occurred from executing the mutation.

•[UserError!]!non-nullDeprecated

Was this section helpful?


Was this section helpful?