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

# HubSpot

> Sync HubSpot contacts into lists and publish conversation activity back to HubSpot

HubSpot connects your customer management system so you can bring contacts into a Botcadence list and send conversation activity and updated details back to HubSpot.

## Prerequisites

* A HubSpot account you are allowed to connect
* Either permission to complete HubSpot OAuth, or a **private app token** with access to contacts
* Permission to add integrations on the project

## Connect

<Steps>
  <Step title="Open Add Integration">
    In the project sidebar, select **Integrations**, then **Add Integration**. Select **Connect** on the **HubSpot** card.
  </Step>

  <Step title="Authorize or paste a token">
    On **Connect HubSpot**, either complete **Authorize HubSpot**, or paste a **Private app token**.
  </Step>

  <Step title="Finish">
    Complete the wizard until you see **HubSpot Connected!**
  </Step>
</Steps>

## Verify

On **Integrations**, the row shows **Connected**. If a list sync shows **Needs Reconnect**, edit this integration and authorize HubSpot again.

<Check>
  Open **Contacts Lists**, configure list sync, pick this connection, and confirm contacts that match your rules appear on the list.
</Check>

## Use it

### List sync (pull contacts)

On **Contacts Lists**, open the list → sync / connection settings. Set **Connection** to this HubSpot integration. Contacts that match the sync rules are added to the list.

You must connect HubSpot on **Integrations** before the list can pull contacts.

### Publish conversation data (push)

On a campaign, inbound, or channel **Integrations** tab, set **Destination** to this HubSpot connection (instead of in-app only, Sheets, or Zapier). Conversation activity is logged on the CRM timeline. Map extra fields when the dashboard shows field mapping.

<Info>
  Timeline logging of summary, topics, and a transcript excerpt does not require extra mapping. Field updates need the mappings you configure on that source.
</Info>

## Limits

* HubSpot here is for CRM sync and publish. It is not the chat widget.
* OAuth tokens expire or get revoked; reconnect if sync shows **Needs Reconnect**.
* You cannot send the same conversation to HubSpot and Zapier at once as extra destinations.

## Troubleshooting

<AccordionGroup>
  <Accordion title="List sync has no connections">
    Connect HubSpot on **Integrations** first, then return to the list.
  </Accordion>

  <Accordion title="OAuth or token fails">
    Use a private app token with contact access, or complete HubSpot authorization with an account that can install the app.
  </Accordion>

  <Accordion title="Nothing appears in HubSpot">
    Confirm the campaign, inbound, or channel **Destination** is this HubSpot connection, and that a conversation finished on that source.
  </Accordion>
</AccordionGroup>