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

# HubSpot

![HubSpot](https://upload.wikimedia.org/wikipedia/commons/thumb/3/3f/HubSpot_Logo.svg/2560px-HubSpot_Logo.svg.png)

<br />

## Configuration

To set up the HubSpot source, provide the following configuration parameters:

| Key                  | Description                                                                        | Sample Value           |
| -------------------- | ---------------------------------------------------------------------------------- | ---------------------- |
| `access_token`       | Secret access token used to make authenticated API requests.                       | `my_token`             |
| `disable_collection` | If `false`, disables the collection of anonymous usage metrics.                    | `false`                |
| `request_timeout`    | Timeout (in seconds) for API requests.                                             | `300`                  |
| `start_date`         | Cutoff date for syncing historical data. Format: ISO8601 (`YYYY-MM-DDTHH:MM:SSZ`). | `2023-01-01T00:00:00Z` |

<br />

## How to Get `access_token`

Follow HubSpot’s [documentation](https://developers.hubspot.com/docs/api/private-apps) to create a Private App and generate your `access_token`.

<br />

### Scopes

Select all the **Read** scopes (except `crm.objects.feedback_submissions`) under the **CRM** section.

| Scope                          | Read |
| ------------------------------ | ---- |
| `crm.lists`                    | ✅    |
| `crm.objects.companies`        | ✅    |
| `crm.objects.contacts`         | ✅    |
| `crm.objects.custom`           | ✅    |
| `crm.objects.deals`            | ✅    |
| `crm.objects.line_items`       | ✅    |
| `crm.objects.marketing_events` | ✅    |
| `crm.objects.owners`           | ✅    |
| `crm.objects.quotes`           | ✅    |
| `crm.schemas.companies`        | ✅    |
| `crm.schemas.contacts`         | ✅    |
| `crm.schemas.custom`           | ✅    |
| `crm.schemas.deals`            | ✅    |
| `crm.schemas.line_items`       | ✅    |
| `crm.schemas.quotes`           | ✅    |

<br />