> ## 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 Yotpo to reward points when customers link a retailer account.

## Create a Custom Action in Yotpo

In your Yotpo admin, navigate to [*Manage Program → Rewards Program → Manage earning rules*](https://loyalty-app.yotpo.com/rewards-program/earning-rules) and click `Create earning rule`. Choose `Custom Action`.

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

Set the **Action name** (e.g. `Linked an Account`) and configure the **Reward type** as a fixed number of points. Save the rule.

<img src="https://mintcdn.com/typecastleinc/rWC4pMP5Mv_G5OWc/images/integrations/yotpo/linked-an-account.png?fit=max&auto=format&n=rWC4pMP5Mv_G5OWc&q=85&s=a2144719de6279ef99a652f6348c149f" alt="yotpo linked an account earning rule" className="rounded-lg border border-gray-100" width="1860" height="926" data-path="images/integrations/yotpo/linked-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 [Yotpo integration](https://dashboard.subtotal.com/integrations/yotpo) and click `Add action`.

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

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

<Note>
  Subtotal does not send a point value for Yotpo `account.linked` events — the points are taken from the rule you configured on the Yotpo Custom Action. The **Points** field in the Subtotal form is not used for Yotpo and can be left at `0`.
</Note>

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

<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>
