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

# HubSpot Sync Guide

Configure field mapping and data synchronization to automatically sync processed list data back to your HubSpot CRM.

## Overview

The HubSpot sync back integration ensures that your processed list data flows seamlessly into your HubSpot CRM with proper field mapping, contact creation, and activity tracking.

## Prerequisites

**AllGood Setup**:

* Completed [setup and prerequisites](/use-cases/list-upload/setup)
* Template structure defined
* Processing features selected

## Configuration Steps

<Steps>
  <Step title="Configure Field Mapping">
    **Standard Field Mapping**:

    | List Field | HubSpot Property     | Mapping Type        |
    | ---------- | -------------------- | ------------------- |
    | Email      | email                | Direct              |
    | First Name | firstname            | Direct              |
    | Last Name  | lastname             | Direct              |
    | Company    | company              | Company Association |
    | Job Title  | jobtitle             | Direct              |
    | Phone      | phone                | Direct              |
    | Industry   | industry             | Standardized        |
    | Location   | city, state, country | Split Mapping       |

    **Custom Property Mapping**:

    * Campaign source → Custom property: "Campaign Source"
    * Lead score → Custom property: "AI Lead Score"
    * Processing date → Custom property: "List Upload Date"
    * Data source → Custom property: "Data Source"
  </Step>

  <Step title="Contact Creation Rules">
    **Duplicate Handling**:

    * **Primary Match**: Email address (exact match)
    * **Secondary Match**: First name + last name + company
    * **Action Options**:
      * Update existing contact
      * Create new contact
      * Skip duplicate

    **Contact Lifecycle**:

    * New contacts → "Lead" lifecycle stage
    * Existing contacts → Preserve current stage
    * Enriched data → Update without stage change
  </Step>
</Steps>