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

# HubSpot

> Create HubSpot contacts and attach response notes automatically from form submissions.

The HubSpot integration creates a new contact in your HubSpot CRM and optionally attaches a note with all response answers whenever a session completes. It connects via OAuth — no API keys to manage.

***

## Setup

<Steps>
  <Step title="Connect your HubSpot account">
    Go to **Integrations → New integration → HubSpot**. Click **Connect to HubSpot**. You'll be redirected to HubSpot to authorise Feedal. After authorising, you're returned to Feedal and the integration is created.
  </Step>

  <Step title="Map form fields">
    Configure which form questions map to HubSpot contact properties. This is optional — if no fields are mapped, Feedal still creates a contact with a note containing all answers.
  </Step>

  <Step title="Attach to a form">
    Open a form and go to the **Connect** tab. Find the HubSpot integration and click **Connect**. Select which events should trigger a delivery.
  </Step>
</Steps>

***

## Configuration

| Field                   | Description                                                            |
| ----------------------- | ---------------------------------------------------------------------- |
| **Create contact**      | Creates a new HubSpot contact for each response (on by default)        |
| **Create note**         | Attaches a note with all answers to the contact (on by default)        |
| **Email field ID**      | Node ID of the form question containing the respondent's email address |
| **First name field ID** | Node ID of the question containing the respondent's first name         |
| **Last name field ID**  | Node ID of the question containing the respondent's last name          |

<Tip>
  To find a node ID, open the question in the studio and look at the URL, or
  check the node card in the workflow canvas. Node IDs look like `node_abc123`.
</Tip>

***

## What gets created

When a session completes:

1. A **contact** is created (or updated if the email already exists) with the mapped first name, last name, and email.
2. If **Create note** is on, a note is attached to the contact containing every question and answer from the session.

***

## Reconnecting

OAuth tokens are refreshed automatically. If the connection breaks (e.g. you revoke access in HubSpot), the integration status changes to `error`. Click **Reconnect** to re-authorise.

***

## Next steps

<CardGroup cols={2}>
  <Card title="Pipedrive" icon="building-2" href="/integrations/pipedrive">
    Create Pipedrive persons and notes instead.
  </Card>

  <Card title="How integrations work" icon="circle-info" href="/integrations/overview">
    Event model, delivery log, and retry logic.
  </Card>
</CardGroup>