> ## Documentation Index
> Fetch the complete documentation index at: https://docs.subtotal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Rewarding linked accounts

> Set up Rivo to reward points when customers link a retailer account.

## Create a Custom Action in Rivo

In your Rivo admin, navigate to the Loyalty Program and click `Add Another Way to Earn`. Choose `Custom Action`.

<img src="https://mintcdn.com/typecastleinc/rWC4pMP5Mv_G5OWc/images/integrations/rivo/rivo-custom-action.png?fit=max&auto=format&n=rWC4pMP5Mv_G5OWc&q=85&s=48b2add1444f9a11d59a04820ce4aa02" alt="rivo custom action" className="rounded-lg border border-gray-100" width="2352" height="1556" data-path="images/integrations/rivo/rivo-custom-action.png" />

Give the action a name (e.g. `Link an Account`). The points you set on the rule will be overridden by Subtotal, so you can leave them at a placeholder value (e.g. `1`) — the actual reward comes from the Subtotal-side configuration you'll set up next. Save the rule.

<img src="https://mintcdn.com/typecastleinc/rWC4pMP5Mv_G5OWc/images/integrations/rivo/link-an-account.png?fit=max&auto=format&n=rWC4pMP5Mv_G5OWc&q=85&s=e3335c12608fea78984c0eb728d9ffc5" alt="rivo link an account earning rule" className="rounded-lg border border-gray-100" width="2368" height="1460" data-path="images/integrations/rivo/link-an-account.png" />

Keep the **Action Name** value handy — you'll use the exact same string in the matching Subtotal action.

## Add the action in Subtotal

In the Subtotal Dashboard, navigate to your [Rivo integration](https://dashboard.subtotal.com/integrations/rivo) and click `Add action`.

Choose `account.linked` as the event, and set **Action name** to the same value you used on your Rivo Custom Action. Optionally restrict to specific retailers.

<img src="https://mintcdn.com/typecastleinc/ghrkNc71FS27YDpM/images/integrations/rivo/rivo-link-action.png?fit=max&auto=format&n=ghrkNc71FS27YDpM&q=85&s=8b365a97a3e1eea8b042658a86f40715" alt="add account.linked action in subtotal" className="rounded-lg border border-gray-100" width="576" height="460" data-path="images/integrations/rivo/rivo-link-action.png" />

Set the **Points** field to the number of points you want to award. Subtotal sends this value to Rivo as `points_amount` on every `account.linked` event, so whatever you set here is what the customer receives.

Click `Create`. Subtotal will now trigger the matching Custom Action in Rivo whenever a customer links a qualifying retailer account.

<Note>
  Because Subtotal always supplies `points_amount`, the points configured on your Rivo Custom Action rule are effectively overridden. You can leave the rule's points at a placeholder value — the actual reward comes from the Subtotal **Points** field.
</Note>

<Note>
  Points are awarded on the first successful activation of each connection. Re-authenticating an existing connection (for example, after a retailer password change) does not re-award points. Creating a fresh connection after a disconnect will.
</Note>
