diff --git a/site/docs/reference/Connectors/capture-connectors/hubspot.md b/site/docs/reference/Connectors/capture-connectors/hubspot.md index f083d4daee..6d61d76461 100644 --- a/site/docs/reference/Connectors/capture-connectors/hubspot.md +++ b/site/docs/reference/Connectors/capture-connectors/hubspot.md @@ -1,9 +1,9 @@ --- sidebar_position: 3 --- -# Hubspot +# HubSpot -This connector captures data from a Hubspot account. +This connector captures data from a HubSpot account. It is available for use in the Flow web application. For local development or open-source workflows, [`ghcr.io/estuary/source-hubspot:dev`](https://ghcr.io/estuary/source-hubspot:dev) provides the latest version of the connector as a Docker image. You can also follow the link in your browser to see past image versions. @@ -13,7 +13,7 @@ but keep in mind that the two versions may be significantly different. ## Supported data resources -By default, each resource associated with your Hubspot account is mapped to a Flow collection through a separate binding. +By default, each resource associated with your HubSpot account is mapped to a Flow collection through a separate binding. The following data resources are supported for all subscription levels: @@ -50,29 +50,29 @@ The following data resources are supported for pro accounts (set **Subscription ## Prerequisites -There are two ways to authenticate with Hubspot when capturing data: using OAuth2, and manually, with a private app access token. +There are two ways to authenticate with HubSpot when capturing data: using OAuth2, and manually, with a private app access token. Their prerequisites differ. OAuth is recommended for simplicity in the Flow web app; the access token method is the only supported method using the command line. -### Using OAuth2 to authenticate with Hubspot in the Flow web app +### Using OAuth2 to authenticate with HubSpot in the Flow web app -* A Hubspot account +* A HubSpot account ### Configuring the connector specification manually -* A Hubspot account +* A HubSpot account -* The access token for an appropriately configured [private app](https://developers.hubspot.com/docs/api/private-apps) on the Hubspot account. +* The access token for an appropriately configured [private app](https://developers.hubspot.com/docs/api/private-apps) on the HubSpot account. #### Setup -To create a private app in Hubspot and generate its access token, do the following. +To create a private app in HubSpot and generate its access token, do the following. -1. Ensure that your Hubspot user account has [super admin](https://knowledge.hubspot.com/settings/hubspot-user-permissions-guide#super-admin) privileges. +1. Ensure that your HubSpot user account has [super admin](https://knowledge.hubspot.com/settings/hubspot-user-permissions-guide#super-admin) privileges. -2. In Hubspot, create a [new private app](https://developers.hubspot.com/docs/api/private-apps#create-a-private-app). +2. In HubSpot, create a [new private app](https://developers.hubspot.com/docs/api/private-apps#create-a-private-app). 1. Name the app "Estuary Flow," or choose another name that is memorable to you. @@ -83,7 +83,7 @@ To create a private app in Hubspot and generate its access token, do the followi ## Configuration You configure connectors either in the Flow web app, or by directly editing the catalog specification file. -See [connectors](../../../concepts/connectors.md#using-connectors) to learn more about using connectors. The values and specification sample below provide configuration details specific to the Hubspot source connector. +See [connectors](../../../concepts/connectors.md#using-connectors) to learn more about using connectors. The values and specification sample below provide configuration details specific to the HubSpot source connector. ### Properties @@ -125,6 +125,6 @@ captures: target: ${PREFIX}/${COLLECTION_NAME} ``` Your configuration will have many more bindings representing all supported [resources](#supported-data-resources) -in your Hubspot account. +in your HubSpot account. [Learn more about capture definitions.](../../../concepts/captures.md#pull-captures)