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

# How Do I Integrate HubSpot with Gameball?

> Keep your customers in sync across Gameball and HubSpot, and target them based on your loyalty data, like current tier and points balance.

## Why Integrate HubSpot with Gameball?

This integration allows you to target and segment your customers based on how loyal they are to your app. With this integration, you can:

* **Check Gameball custom attributes** on HubSpot.
* **Trigger workflows** based on Gameball customer attributes.

***

## How to Configure HubSpot on Gameball

<Steps>
  <Step title="Connect HubSpot">
    Go to **Integrations** on your **Gameball Admin Dashboard** and click **Connect** under **HubSpot**.

    <Frame>
      <img src="https://mintcdn.com/gameball/rAvMcwJweaNUX1m4/images/product-docs/apps-integrations/apps-integrations-41.png?fit=max&auto=format&n=rAvMcwJweaNUX1m4&q=85&s=45a38fbfacab80ba5695db8554926c9d" width="2706" height="1378" data-path="images/product-docs/apps-integrations/apps-integrations-41.png" />
    </Frame>
  </Step>

  <Step title="Get Your API Key">
    1. Install HubSpot from the Shopify App Store.
    2. In your HubSpot account, go to **Settings > Integrations**.
    3. Copy the **API token**.

    <Frame>
      <img src="https://mintcdn.com/gameball/rAvMcwJweaNUX1m4/images/product-docs/apps-integrations/apps-integrations-42.png?fit=max&auto=format&n=rAvMcwJweaNUX1m4&q=85&s=25ad3ac1ae8907a98d561a749afdcfac" width="1507" height="760" data-path="images/product-docs/apps-integrations/apps-integrations-42.png" />
    </Frame>
  </Step>

  <Step title="Paste Credentials in Gameball">
    Paste the API token on your Gameball Admin Dashboard and click **Next**.

    <Frame>
      <img src="https://mintcdn.com/gameball/rAvMcwJweaNUX1m4/images/product-docs/apps-integrations/apps-integrations-43.png?fit=max&auto=format&n=rAvMcwJweaNUX1m4&q=85&s=394b230837829cf6b23d5b26c5da74f0" width="1544" height="872" data-path="images/product-docs/apps-integrations/apps-integrations-43.png" />
    </Frame>
  </Step>

  <Step title="Add Customer Attributes">
    Click **Add** so the list of customer attributes will be automatically added to your HubSpot account.

    <Note>
      Make sure you use these attributes with the notation provided on your Gameball Admin Dashboard, as described below.
    </Note>

    <Frame>
      <img src="https://mintcdn.com/gameball/rAvMcwJweaNUX1m4/images/product-docs/apps-integrations/apps-integrations-44.png?fit=max&auto=format&n=rAvMcwJweaNUX1m4&q=85&s=c5fca124a586a16f3281df87d6afeab7" width="1521" height="886" data-path="images/product-docs/apps-integrations/apps-integrations-44.png" />
    </Frame>
  </Step>
</Steps>

***

## Using Gameball Data in HubSpot

### Check Customer Attributes

Go to **Contacts > Select a specific contact** to view the custom attributes.

<Frame>
  <img src="https://mintcdn.com/gameball/rAvMcwJweaNUX1m4/images/product-docs/apps-integrations/apps-integrations-45.png?fit=max&auto=format&n=rAvMcwJweaNUX1m4&q=85&s=94ba51a5d5bcaca83a000e25005c56ea" width="1709" height="777" data-path="images/product-docs/apps-integrations/apps-integrations-45.png" />
</Frame>

### Trigger Workflows

Go to **Automation > Workflows > Actions > Set Enrollment Trigger > Contact Properties** to trigger a workflow based on a Gameball customer attribute.

<Frame>
  <img src="https://mintcdn.com/gameball/rAvMcwJweaNUX1m4/images/product-docs/apps-integrations/apps-integrations-46.png?fit=max&auto=format&n=rAvMcwJweaNUX1m4&q=85&s=2d1f25479af7f845af1b5f84763561e0" width="1672" height="743" data-path="images/product-docs/apps-integrations/apps-integrations-46.png" />
</Frame>
