Appearance
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
- Go to Connections and click New Connection.
- Pick HubSpot from the marketplace.
- Enter your credentials (see Authentication above for what's expected).
- In a workflow, drop an API Call node and select this connection.
- 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
- Add an API Call node to your workflow.
- Pick your HubSpot connection from the Connection dropdown.
- In the Operation dropdown, select
crm.listContacts. - 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
- Add an API Call node to your workflow.
- Pick your HubSpot connection from the Connection dropdown.
- In the Operation dropdown, select
crm.createContact. - 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
- Add an API Call node to your workflow.
- Pick your HubSpot connection from the Connection dropdown.
- In the Operation dropdown, select
crm.getContact. - 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
- Add an API Call node to your workflow.
- Pick your HubSpot connection from the Connection dropdown.
- In the Operation dropdown, select
crm.listDeals. - 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
- Add an API Call node to your workflow.
- Pick your HubSpot connection from the Connection dropdown.
- In the Operation dropdown, select
crm.createDeal. - 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
- Add an API Call node to your workflow.
- Pick your HubSpot connection from the Connection dropdown.
- In the Operation dropdown, select
crm.listCompanies. - 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
- Add an API Call node to your workflow.
- Pick your HubSpot connection from the Connection dropdown.
- In the Operation dropdown, select
crm.createCompany. - 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.