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

# HubSpot

> Sync Callaro outcomes into HubSpot contacts, notes, and lifecycle workflows.

# HubSpot is typically the fastest CRM integration to operationalize.

<CardGroup cols={2}>
  <Card title="Write path" icon="arrow-right-left">Create notes, update properties, and move lifecycle stages after a call.</Card>
  <Card title="Read path" icon="search">Load lead or account context before a conversation so the AI starts informed.</Card>
</CardGroup>

## Prerequisites

* HubSpot admin token with contact and engagement write access.
* Field ownership decision for lifecycle stage and call outcome fields.
* Sandbox CRM test path for supervised validation.

## Setup flow

1. Authorize HubSpot connection in Callaro.
2. Map required fields (owner, outcome, next step, call URL/transcript link).
3. Configure write triggers by call outcome.
4. Run small supervised campaign and inspect resulting HubSpot records.
5. Approve production rollout after data quality review.

## Validation checklist

* Notes are created on the correct contact/company.
* Outcome field values match Callaro call outcome vocabulary.
* Duplicate note creation is prevented on webhook retries.
* Timeline entries include traceable call IDs.

## Known limits

* Overwriting lifecycle stage can disrupt existing sales automations.
* Free-text fields can drift without controlled taxonomy.
* Large batch backfills should be throttled to API rate limits.

<Warning>Lock down field mappings before go-live. Unreviewed freeform writes create cleanup work quickly.</Warning>

## What to do next

* Review [`../concepts/crm-and-calendar-actions`](../concepts/crm-and-calendar-actions) to align action scope and ownership.
* Review [`../guides/analytics-and-exports`](../guides/analytics-and-exports) for reconciliation patterns.
* Review [`../api-reference/idempotency`](../api-reference/idempotency) before enabling production write automation.