--- title: "Creating an Action-Based VIP Tier" slug: "creating-an-action-based-vip-tier" tags: ["Loyalty and Referrals"] updated: 2024-04-02T22:27:07Z published: 2024-04-02T22:27:07Z canonical: "support.yotpo.com/creating-an-action-based-vip-tier" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.yotpo.com/llms.txt > Use this file to discover all available pages before exploring further. # Creating an Action-Based VIP Tier Products Loyalty & Referrals ###### Supported plans Premium, Enterprise ###### eCommerce Platform N/A You can automatically grant certain customers a special VIP tier status after they complete an action of your choice. In this article, we will show you how to set up an action-based VIP tier by using an example action of automatically inserting product subscribers into VIP tiers and removing them once the subscription is complete. Please note: - If you do not see this feature in your account, reach out to your Account Manager for additional details - Setting up this feature requires the help of a developer ## How it works In our action example, when a customer creates a subscription, Yotpo receives a trigger that allows marking the action as completed and automatically gives the customer a VIP tier status for completing the subscription action. This can be implemented for any action of your choosing. There are 3 main steps to creating your Yotpo action-based VIP tier: 1. **Send Yotpo information about a completed action** - Set up an action that can be completed by the customer and make sure to send us an API call saying the action has been completed. 2. **Create a VIP Action Based earning rule** - Create an earning rule that requires the chosen action to be completed by a customer to receive a reward. 3. **Add a new VIP tier** - Add a VIP tier to your VIP tier program and set up the specific benefits the customer will receive for completing the action. Important: - You can have only one action-based VIP tier - You cannot have both a paid membership program and an action-based tier. To learn more about the paid membership program, go to [Setting up a Loyalty & Referrals Membership Program](https://support.yotpo.com/docs/yotpo-loyalty-referrals-membership-program) ## Sending Yotpo an ‘action completed’ API call The completed action API call needs to be sent to Yotpo once the customer has completed the relevant action. In this example, we will set up a tier for customers who purchased a subscription: Use the [Record a Customer Action](https://loyaltyapi.yotpo.com/reference/record-a-customer-action) endpoint with the following parameters: - type: EnterHighestTier - customer_email - customer_id (optional) - As it appears in your eCommerce platforms - action_name: EnterHighestTier static - History_title (optional) - Enter if you want to override what you have set in the earning rule. This is what the customer will see in the rewards history section of the rewards page/my activity module when they enter the tier. In this case, the action can be “Made a subscription”. Please note: - The customer must be opted into the loyalty program **before** the API call is sent - Do not send any point-related information when using the endpoint, otherwise, the customer will receive the reward twice After you’ve established the API call that sends information to Yotpo, you can set up the earning rule and reward. ## Creating an earning rule Start by creating an earning rule for the action: 1. In the Yotpo Loyalty & Referrals main menu, go to **Set Up Program >** [**Rewards Program**](https://loyalty-app.yotpo.com/rewards-program). 2. Click **+Create earning rule** and choose **VIP Action Based**. 3. Under Advanced settings, you can choose to limit this earning rule to a specific audience or exclude certain audiences from participating. 4. Give your earning rule a name that reflects the action the customer needs to complete, for example, “Purchase a monthly subscription”. 5. Click **Save**. After the earning rule is created, you can continue creating and setting up a VIP tier. ## Adding a VIP tier Now you can create the VIP tier and choose the tier rewards: 1. Go to **Set Up Program >** [**VIP Tiers Program**](https://loyalty-app.yotpo.com/vip-tiers). 2. Click **+Add New Tier**. 3. Click **+Add Threshold > Campaign Completed** and choose the newly created earning rule. ![](https://cdn.document360.io/f3c2ab59-fe4c-4f93-9614-2872f40e8aa7/Images/Documentation/creating-an-action-based-vip-tier-image-jd8ynhfu.png?sv=2026-02-06&spr=https&st=2026-10-31T10%3A08%3A17Z&se=2026-10-31T11%3A08%3A17Z&sr=c&sp=r&sig=RF4MyTXeEp0SKJhRwZlTIAICX5OZqknu1aK6xIZjEcE%3D) 4. Choose the reward the customers will receive once they complete the action and earn this new VIP tier status. 5. Click **Apply to Tiers** to finish the tier setup. Please note: If you want the customer to remain in this VIP tier after the tier term has ended, you’ll need to once again use the [Record a Customer Action](https://loyaltyapi.yotpo.com/reference/record-a-customer-action) endpoint. ## Removing a customer from the action-based VIP tier Following our subscription example, you can use the [Remove a Customer from an Action-Based VIP Tier](https://loyaltyapi.yotpo.com/reference/removing-a-customer-from-an-action-based-vip-tier) API endpoint to remove a customer from the VIP tier once their subscription is over. The customer will then automatically enter the VIP tier that is relevant to them according to your VIP tier program setup. If the customer is not removed from the action-based tier after the subscription ends, they will remain in the tier for as long as you have set in the tier settings. If, for example, you set the tier to “Rolling year”, the customer will remain there until 12 months have passed since they were added to the tier. ## Next steps You can see how your VIP tiers are performing by going to the [VIP Tiers Performance dashboard](https://loyalty-app.yotpo.com/vip-tiers-dashboard). To learn more about the dashboard, go to the [VIP Tiers Dashboard](https://support.yotpo.com/docs/vip-tiers-dashboard) article.