> For the complete documentation index, see [llms.txt](https://developer.gyfti.fr/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.gyfti.fr/hubspot-integration-v2/rewarding-users-with-points.md).

# Rewarding Users with Points

### **Use Case: Reward Users with Points via HubSpot**

#### **What you'll build**

Automatically add points to a member in Gyfti when a condition is met in a HubSpot workflow (e.g. after reaching a milestone), and move them to a segment.

***

#### **Prerequisites**

Before starting, make sure you have:

* An **Engage or Grow workspace connected to HubSpot** (see Setting up HubSpot)
* The contact is already a **member of the espace** (they joined it). The action updates members, it does not create them

***

#### **Step 1: Create a HubSpot workflow**

* Go to HubSpot → Workflows
* Create a **contact-based workflow**
* Define your trigger (e.g. action completed, form submitted, lifecycle stage updated, or a Gyfti trigger such as *Espace joined (Gyfti v2)*)

***

#### **Step 2: Add Gyfti action**

* Add action:\
  👉 **Edit a Gyfti user (Gyfti v2)**

***

#### **Step 3: Configure the action**

* **Espace** *(required)*: the espace whose balance you change
* **Email** *(required)*: map it to the contact's email property
* **First name**, **Last name** *(optional)*
* **Points** and **Points value** *(optional)*: the mode and the amount
* **Segment** or **Or new segment** *(optional)*
* **Send email** *(optional)*

***

#### **Important behavior**

**You choose: add points or set the balance**

* **Add points** adds the value to the member's current balance
* **Set balance to** replaces the balance with the value

👉 Example:

* Member has 100 points
* **Add points** 50 → member now has **150 points**
* **Set balance to** 50 → member now has **50 points**

> **Add points** adds again every time the workflow runs on the same contact. If the contact can be re-enrolled and you want the same result each time, use **Set balance to**.

***

**Segments**

* **Segment** lists the segments of the espace you picked. The member is moved into it (a member is in one segment at a time)
* **Or new segment** lets you type a name instead:
  * If a segment with that name exists in the espace → the member is moved into it (capitals, accents and spaces are ignored when matching)
  * If it does not exist → it is **automatically created**, and the member is moved into it

👉 This can be used to **sync HubSpot lists with Gyfti segments**

The outputs **Segment created** and **Segment used** tell you what happened, so the rest of your workflow can branch on it.

***

**Send email option**

* Set **Send email** to **Yes** → the member receives an email with their new points balance
* It is only sent when the action changed their points. Empty means no email

***

#### **Step 4: Enroll contacts**

When a contact enters the workflow:

* Gyfti finds the member in the chosen espace (based on email)
* Name and segment are updated first, then the points
* If something fails, the workflow history shows the first failure in red, with the reason

***

#### **What happens next**

* The member sees their updated points balance in their espace
* (Optional) They receive an email notification
* They can use their points to redeem rewards in the espace

***

#### **Validating challenges instead**

If the points come from a Grow challenge, use **Validate challenge submission (Gyfti v2)** instead: it approves the member's pending submission and credits the challenge's own points. See the Triggers and Actions reference.
