> 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/setting-up-hubspot.md).

# Setting up HubSpot

### **Setup guide for Gyfti-App**

Gyfti-App connects a Gyfti workspace to your HubSpot account, which lets you:

* Send gifts to HubSpot contacts from a workflow
* Reward your Gyfti members with points, move them between segments and validate their challenge submissions
* See what your members do in Gyfti (joining, signing in, submitting and validating challenges) on your contacts' timeline

***

#### Before you start

* The **Connexion CRM** pack on the workspace you want to connect. Without it, the Applications tab reads « La connexion CRM ne fait pas partie de cet abonnement »: contact us to add it.
* The **admin** role on that workspace.

> **One connection per workspace.** Each workspace (Touch, Engage or Grow) connects to HubSpot on its own. Several workspaces of the same organisation can share one HubSpot account.

***

**Install the app**

* Log in to [app-v2.gyfti.fr](https://app-v2.gyfti.fr) and open the workspace you want to connect.
* Navigate to **Réglages** > **Intégrations** > **Applications**.
* On the HubSpot card, click **Connecter HubSpot**.<br>

  <figure><img src="https://1285487192-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzlFqP7uYkQYXxFfD1DD6%2Fuploads%2FoKIctc4CESt3325i2hF7%2Fimage.png?alt=media&amp;token=555bd5b2-99e4-45e8-a8fd-52c18996d0d2" alt=""><figcaption></figcaption></figure>
* Select your **HubSpot account** and click **Choose Account**.
* Review the requested scopes. Gyfti-App requests read and write access to your contacts, and access to the timeline. Nothing else (no deals, no companies).
* Click **Connect app**.
* You are redirected back to Gyfti and the HubSpot card shows the connected account.

<figure><img src="https://1285487192-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzlFqP7uYkQYXxFfD1DD6%2Fuploads%2Fdso0rLD0NKQucZdifgfD%2Fimage.png?alt=media&amp;token=823ffef4-a71e-48eb-9be3-2ee88df2ff4f" alt=""><figcaption></figcaption></figure>

There is nothing else to set up. The API key your workflows need is created automatically with the connection, and is listed read-only in the **Clés API** tab.

***

**Use the app**

To learn how to set up your workflows, refer to the following sections:

[Rewarding Users with Points](https://developer.gyfti.fr/hubspot-integration-v2/rewarding-users-with-points.md)

[Triggers and Actions reference](https://developer.gyfti.fr/hubspot-integration-v2/triggers-and-actions-reference.md)

***

**Disconnect a workspace**

> **Note:** once a workspace is unlinked, HubSpot workflows stop acting on it and its events stop reaching your contacts' timeline. Events already sent stay in HubSpot. The HubSpot account stays connected for your other workspaces.

* Log in to [app-v2.gyfti.fr](https://app-v2.gyfti.fr) and open the workspace, then **Réglages** > **Intégrations** > **Applications**.
* On the HubSpot card, click **Délier** and confirm.

You can reconnect the workspace later in one click.

***

**Disconnect the HubSpot account for the whole organisation**

* The organisation owner opens **Organisation** > **Intégrations**. This page lists your HubSpot accounts and the workspaces connected to each.
* Click **Déconnecter** on the account. The confirmation says how many workspaces lose HubSpot.

Every workspace on that account stops at once. Their settings are kept: if you reconnect the account later, they come back without being reconnected one by one, and meanwhile they show « à reconnecter ».

***

**Choose what reaches your contacts' timeline**

On the HubSpot card, « Ce qui remonte dans la timeline de vos contacts » lists the four events. An admin turns each one on or off in one click. The same page shows the recent activity: the events sent to HubSpot and their status, and the workflow actions received.

***

**Uninstall the app**

To uninstall Gyfti-App from your HubSpot account, follow the instructions in [this HubSpot Knowledge Base article](https://knowledge.hubspot.com/integrations/connect-apps-to-hubspot#uninstall-an-app). This disconnects every Gyfti workspace using that account.
