Home API and integrations | Keys, endpoints and webhooks API: Import Contact via Hubspot Integration

API: Import Contact via Hubspot Integration

Last updated on Oct 21, 2025

Importing Contact Using Webhook Trigger in Hubspot

Using our import endpoint, you can create or update your contacts in Cloud Chat through webhooks integrated with Hubspot.

Example of Webhook Configuration Using Workflows in Hubspot

To create a contact import webhook in a Hubspot workflow, follow the steps below.

Step 1: Creating the Workflow

In the main Hubspot sidebar, hover over the automation icon and then click on Workflows to go to the workflows dashboard:

Once in the dashboard, click on Create workflow and select From scratch:

For the workflow type configuration, select Contact-based and click Next:

Step 2: Configuring the Webhook Request

With the initial workflow setup completed, now you need to construct the payload to be sent in the webhook.

To start configuring the webhook, click the add action button (+):

On the left panel, click Data Operations and then select Send a webhook:

In the method selector, choose POST:

Next, fill in the webhook URL and API key information:

Note: The API key must be configured in manage secrets.

Finally, fill in the contact information fields to trigger the webhook: name (Name), phone_number (Phone), email, identifier (Unique contact ID), as well as any other available custom attributes:

Note: At least one of phone_number, email, or identifier is required to create a contact.

If the contact exists in your database, it will be updated with the provided fields. Otherwise, a new contact will be added.