has the ability to push events to you via webhooks when things happen on our system. The below table is a list of all topics we support. Each topic also has its own page which describes the body of the webhook. The topic is contained in a header along with the webhook ID.


  • X-Webhook-Topic
  • X-Webhook-Id

Supported Webhook Topics

Webhook TopicDescription
customers/updatedTriggered when a customer is updated.
customers/tier_changedTriggered when a customer's tier has changed.
customers/tier_entry_reward_earnedTriggered when a customer is rewarded an entry reward for entering a tier.
NOTE: This is a required webhook topic if you are using tier entry rewards.
points/earnedTriggered when a customer has earned points.
points/redeemedTriggered when a customer has redeemed points.
NOTE: This is a required webhook topic if you are have enabled the points program.
referrals/startedTriggered when a referral process has started. The webhook body will contain details about who was referred as well as which customer the referral belongs to. A referral is considered started when the customer's friend submits their email address.
referrals/completedTriggered when a referral process has completed. A referral is considered completed once the friend has completed an order with either the discount code awarded from starting a referral or using the email which they submitted to start the referral process.