Mutations

Mutations

addItemToOrder

Adds an item to the order. If custom fields are defined on the OrderLine entity, a third argument ‘customFields’ will be available.

addPaymentToOrder

Add a Payment to the Order

adjustOrderLine

Adjusts an OrderLine. If custom fields are defined on the OrderLine entity, a third argument ‘customFields’ of type OrderLineCustomFieldsInput will be available.

applyCouponCode

Applies the given coupon code to the active Order

authenticate

Authenticates the user using a named authentication strategy

createCustomerAddress

Create a new Customer Address

deleteCustomerAddress

Delete an existing Address

login

Authenticates the user using the native authentication strategy. This mutation is an alias for authenticate({ native: { ... }})

logout

End the current authenticated session

refreshCustomerVerification

Regenerate and send a verification token for a new Customer registration. Only applicable if authOptions.requireVerification is set to true.

registerCustomerAccount

Register a Customer account with the given credentials. There are three possible registration flows:

If authOptions.requireVerification is set to true:

  1. The Customer is registered with a password. A verificationToken will be created (and typically emailed to the Customer). That verificationToken would then be passed to the verifyCustomerAccount mutation without a password. The Customer is then verified and authenticated in one step.
  2. The Customer is registered without a password. A verificationToken will be created (and typically emailed to the Customer). That verificationToken would then be passed to the verifyCustomerAccount mutation with the chosed password of the Customer. The Customer is then verified and authenticated in one step.

If authOptions.requireVerification is set to false:

  1. The Customer must be registered with a password. No further action is needed - the Customer is able to authenticate immediately.

removeAllOrderLines

Remove all OrderLine from the Order

removeCouponCode

Removes the given coupon code from the active Order

removeOrderLine

Remove an OrderLine from the Order

requestPasswordReset

Requests a password reset email to be sent

requestUpdateCustomerEmailAddress

Request to update the emailAddress of the active Customer. If authOptions.requireVerification is enabled (as is the default), then the identifierChangeToken will be assigned to the current User and a IdentifierChangeRequestEvent will be raised. This can then be used e.g. by the EmailPlugin to email that verification token to the Customer, which is then used to verify the change of email address.

resetPassword

Resets a Customer’s password based on the provided token

setCustomerForOrder

Set the Customer for the Order. Required only if the Customer is not currently logged in

setOrderBillingAddress

Sets the billing address for this order

setOrderCustomFields

Allows any custom fields to be set for the active order

setOrderShippingAddress

Sets the shipping address for this order

setOrderShippingMethod

Sets the shipping method by id, which can be obtained with the eligibleShippingMethods query

transitionOrderToState

Transitions an Order to a new state. Valid next states can be found by querying nextOrderStates

updateCustomer

Update an existing Customer

updateCustomerAddress

Update an existing Address

updateCustomerEmailAddress

Confirm the update of the emailAddress with the provided token, which has been generated by the requestUpdateCustomerEmailAddress mutation.

updateCustomerPassword

Update the password of the active Customer

verifyCustomerAccount

Verify a Customer email address with the token sent to that address. Only applicable if authOptions.requireVerification is set to true.

If the Customer was not registered with a password in the registerCustomerAccount mutation, the a password must be provided here.