post
https://api.yotpo.com/loyalty/v3/stores//vip_tiers/customers/:push_to_tier
Manually assigns a customer to a VIP tier, either until a set end date or indefinitely.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
This is the API equivalent of manual tier assignment in the Yotpo Loyalty admin.
Path Parameters
| Key | Type | Required | Description |
|---|---|---|---|
| customer_id | String | Yes | The Yotpo customer ID, not your store platform's customer ID. Get it from the yotpo_customer_id field returned by Fetch Customer Details. |
Request Body
| Key | Type | Required | Description |
|---|---|---|---|
| tier_id | String | Yes | The ID of the tier to assign. Get it from Get VIP Tiers Program. |
| planned_end_at | String | No | When the assignment ends, in ISO 8601 format. If omitted, the customer stays in the tier indefinitely. |
| rewards_policy | String | Yes | AWARD_ENTRY_REWARDS grants the tier's entry rewards. IGNORE_ENTRY_REWARDS assigns the tier without them. |
Note
- Check that the program is
ACTIVEwith Get VIP Tiers Program Status before assigning tiers.- Requests require your Yotpo access token in the
X-Yotpo-Tokenheader.