HubSpot

Manage contacts, deals, and companies through the HubSpot CRM API.

Detail	Value
Category	CRM
Base URL	https://api.hubapi.com
Authentication	Bearer Token
Endpoints	7
Connector key	hubspot

Using HubSpot in a workflow

1. Go to Connections and click New Connection.
2. Pick HubSpot from the marketplace.
3. Enter your credentials (see Authentication above for what's expected).
4. In a workflow, drop an API Call node and select this connection.
5. Pick the operation you need from the Operation dropdown. The full list is below.

Available endpoints

Endpoint	Summary
GET /crm/v3/objects/contacts	List contacts
POST /crm/v3/objects/contacts	Create a contact
GET /crm/v3/objects/contacts/{contactId}	Get a contact by ID
GET /crm/v3/objects/deals	List deals
POST /crm/v3/objects/deals	Create a deal
GET /crm/v3/objects/companies	List companies
POST /crm/v3/objects/companies	Create a company

Each endpoint is documented in full below. Use the outline on the right to jump to one.

GET /crm/v3/objects/contacts

List contacts

Detail	Value
Operation ID	crm.listContacts
Method	GET
Path	/crm/v3/objects/contacts

Parameters

Name	Location	Type	Required
limit	query	integer	No
after	query	string	No

Using this endpoint in a workflow

1. Add an API Call node to your workflow.
2. Pick your HubSpot connection from the Connection dropdown.
3. In the Operation dropdown, select crm.listContacts.
4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream HubSpot API reference.

POST /crm/v3/objects/contacts

Create a contact

Detail	Value
Operation ID	crm.createContact
Method	POST
Path	/crm/v3/objects/contacts

Parameters

No parameters.

Request Body

Field	Type
properties	object

Using this endpoint in a workflow

1. Add an API Call node to your workflow.
2. Pick your HubSpot connection from the Connection dropdown.
3. In the Operation dropdown, select crm.createContact.
4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

Required fields are marked: fill them or the call will fail at runtime.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream HubSpot API reference.

GET /crm/v3/objects/contacts/{contactId}

Get a contact by ID

Detail	Value
Operation ID	crm.getContact
Method	GET
Path	/crm/v3/objects/contacts/{contactId}

Parameters

Name	Location	Type	Required
contactId	path	string	Yes

Using this endpoint in a workflow

1. Add an API Call node to your workflow.
2. Pick your HubSpot connection from the Connection dropdown.
3. In the Operation dropdown, select crm.getContact.
4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

Required fields are marked: fill them or the call will fail at runtime.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream HubSpot API reference.

GET /crm/v3/objects/deals

List deals

Detail	Value
Operation ID	crm.listDeals
Method	GET
Path	/crm/v3/objects/deals

Parameters

Name	Location	Type	Required
limit	query	integer	No

Using this endpoint in a workflow

1. Add an API Call node to your workflow.
2. Pick your HubSpot connection from the Connection dropdown.
3. In the Operation dropdown, select crm.listDeals.
4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream HubSpot API reference.

POST /crm/v3/objects/deals

Create a deal

Detail	Value
Operation ID	crm.createDeal
Method	POST
Path	/crm/v3/objects/deals

Parameters

No parameters.

Request Body

Field	Type
properties	object

Using this endpoint in a workflow

1. Add an API Call node to your workflow.
2. Pick your HubSpot connection from the Connection dropdown.
3. In the Operation dropdown, select crm.createDeal.
4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

Required fields are marked: fill them or the call will fail at runtime.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream HubSpot API reference.

GET /crm/v3/objects/companies

List companies

Detail	Value
Operation ID	crm.listCompanies
Method	GET
Path	/crm/v3/objects/companies

Parameters

Name	Location	Type	Required
limit	query	integer	No

Using this endpoint in a workflow

1. Add an API Call node to your workflow.
2. Pick your HubSpot connection from the Connection dropdown.
3. In the Operation dropdown, select crm.listCompanies.
4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream HubSpot API reference.

POST /crm/v3/objects/companies

Create a company

Detail	Value
Operation ID	crm.createCompany
Method	POST
Path	/crm/v3/objects/companies

Parameters

No parameters.

Request Body

Field	Type
properties	object

Using this endpoint in a workflow

1. Add an API Call node to your workflow.
2. Pick your HubSpot connection from the Connection dropdown.
3. In the Operation dropdown, select crm.createCompany.
4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

Required fields are marked: fill them or the call will fail at runtime.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream HubSpot API reference.