Skip to content
For LLMsView as Markdown·

HubSpot

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

DetailValue
CategoryCRM
Base URLhttps://api.hubapi.com
AuthenticationBearer Token
Endpoints7
Connector keyhubspot

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

EndpointSummary
GET /crm/v3/objects/contactsList contacts
POST /crm/v3/objects/contactsCreate a contact
GET /crm/v3/objects/contacts/{contactId}Get a contact by ID
GET /crm/v3/objects/dealsList deals
POST /crm/v3/objects/dealsCreate a deal
GET /crm/v3/objects/companiesList companies
POST /crm/v3/objects/companiesCreate 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

DetailValue
Operation IDcrm.listContacts
MethodGET
Path/crm/v3/objects/contacts

Parameters

NameLocationTypeRequired
limitqueryintegerNo
afterquerystringNo

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

DetailValue
Operation IDcrm.createContact
MethodPOST
Path/crm/v3/objects/contacts

Parameters

No parameters.

Request Body

FieldType
propertiesobject

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

DetailValue
Operation IDcrm.getContact
MethodGET
Path/crm/v3/objects/contacts/{contactId}

Parameters

NameLocationTypeRequired
contactIdpathstringYes

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

DetailValue
Operation IDcrm.listDeals
MethodGET
Path/crm/v3/objects/deals

Parameters

NameLocationTypeRequired
limitqueryintegerNo

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

DetailValue
Operation IDcrm.createDeal
MethodPOST
Path/crm/v3/objects/deals

Parameters

No parameters.

Request Body

FieldType
propertiesobject

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

DetailValue
Operation IDcrm.listCompanies
MethodGET
Path/crm/v3/objects/companies

Parameters

NameLocationTypeRequired
limitqueryintegerNo

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

DetailValue
Operation IDcrm.createCompany
MethodPOST
Path/crm/v3/objects/companies

Parameters

No parameters.

Request Body

FieldType
propertiesobject

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.