Webhooks

Webhooks are a great way to perform external business logic based on activity that happens in the cart by the customer.

For example, when a cart reaches a certain amount you may want to automatically apply a custom item, or when a cart is converted to an order using the checkout mutation you could send the user an email confirmation.

Using your token

You must pass an Authorization header with your token with each request you want to invoke your webhooks.

Authorization: Bearer <api-key-here>

Cart Webhooks

When each of the cart (and item) mutations are invoked, you will receive a payload containing the new cart state:

  • addItem
  • updateItem
  • removeItem
  • incrementItemQuantity
  • decrementItemQuantity

Checkout Webhooks

When the checkout mutation is invoked, you will receive a payload containing the order.