You can increase or decrease a customer's loyalty balance directly from a Klaviyo flow using a webhook action. This lets you reward points based on email engagement, survey completions, or any other Klaviyo trigger — without leaving the Klaviyo flow builder.
Set up the webhook¶
Get your API key and program slug¶
Go to Settings > Technical > API Keys and copy your API key. Then grab your program slug from Settings > Technical > Program Information.
Add a webhook action to your flow¶
In your Klaviyo flow, add a Webhook action at the point where you want to adjust the balance.
Set the destination URL¶
Use one of these endpoints depending on whether you want to add or remove points:
To increase balance:
https://api.jericommerce.com/v1/programs/{{program_slug}}/balance/increase
To decrease balance:
https://api.jericommerce.com/v1/programs/{{program_slug}}/balance/decrease
Your program slug goes where the placeholder is — find it under Settings > Technical > Program Information.
Add the API key header¶
In the webhook headers, add:
- Key: api-key
- Value: your API key from step 1
Set the JSON body¶
Use this template to target the customer who triggered the flow:
[
{
"email": "{{ person.email }}",
"amount": 100,
"reason": "Bonus points from Klaviyo flow"
}
]
amount is always a positive number — the endpoint you choose (increase or decrease) determines the direction.
Body fields¶
| Field | Required | Description |
|---|---|---|
email |
Yes | The customer's email address — use {{ person.email }} in Klaviyo |
amount |
Yes | Points to add or remove (always a positive number) |
reason |
Yes | A note explaining the change (visible in the customer's activity log) |
Use the Webhook Builder¶
Skip the manual setup — use the Webhook Builder to generate all the values above in seconds.
Increase balance
Open the builder pre-configured for increasing points.
Decrease balance
Open the builder pre-configured for decreasing points.
Flow Ideas¶
Welcome bonus
Give new subscribers bonus points when they join your list or complete a welcome series.
Review reward
Award points when a customer submits a product review (triggered by a review event).
Re-engagement
Offer bonus points to win back customers who haven't purchased in a while.
Birthday bonus
Add extra points on the customer's birthday, on top of any existing birthday earning flow.
reason field too — for example, "Bonus for reviewing {{ event.product_name }}" — so each balance change has a clear explanation in the customer's activity log.