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

# Connect a HubSpot Form to Reevo

> Send HubSpot form submissions to Reevo from a workflow and map custom request-body keys to your CRM.

Connect a HubSpot form to Reevo to create or update CRM records and run a Reevo workflow whenever someone submits the form.

***

## Before you start

You need a published HubSpot form, a HubSpot workflow triggered by that form, and an external form created in Reevo. Follow [Connecting an External Form to Reevo](/Prospecting-and-Outreach/Connecting-an-External-Form#create-the-external-form-in-reevo) to create it and copy its webhook URL.

***

## Add a webhook action in HubSpot

1. Open the HubSpot workflow that runs after the form submission, or create one for the form.
2. Add a **Send a webhook** action after the form-submission trigger.
3. Set the method to `POST`.
4. Paste the webhook URL you copied from Reevo.
5. Select **Customize request body**.

<Frame>
  <img src="https://mintcdn.com/reevoai/hDKcmRBCmReve9Ik/Prospecting-and-Outreach/images/external-form-hubspot-webhook.png?fit=max&auto=format&n=hDKcmRBCmReve9Ik&q=85&s=c44aac4c6243b54b434de85db2796b64" alt="HubSpot's Send a webhook action with the POST URL, customized request body, and mapped form properties." width="1585" height="992" data-path="Prospecting-and-Outreach/images/external-form-hubspot-webhook.png" />
</Frame>

***

## Define and test the request body

HubSpot lets you define the request-body keys that Reevo receives.

1. Add a clear, unique key for each value that you want to send.
2. Connect each key to the corresponding HubSpot property.
3. Save the webhook action.
4. Open **Test action** and provide test values for the configured properties.
5. Send the test request to Reevo.

<Tip>
  Use stable names such as `first_name`, `last_name`, and `company_name`. If you rename a request-body key later, update its mapping in Reevo.
</Tip>

***

## Map and launch the form in Reevo

1. Return to the external form builder in Reevo and click **Populate from submission**.
2. Select the HubSpot test submission.
3. Map each request-body key to its Contact or Account field.
4. Configure the connected workflow, then click **Launch**.
5. Test the HubSpot action again and confirm the submission and workflow appear in Reevo.

<Info>
  For the complete mapping and workflow steps, see [Connecting an External Form to Reevo](/Prospecting-and-Outreach/Connecting-an-External-Form#map-incoming-fields-to-your-crm).
</Info>

***

## Troubleshooting HubSpot

* **The webhook action does not run**: confirm that it follows the correct form-submission trigger and that the workflow is active.
* **A property is missing**: confirm that its request-body key is connected to a HubSpot property and that the test contains a value.
* **The test succeeds but live submissions do not appear**: confirm that the form enrollment criteria match the form you are testing.