HubSpot
API actions for the HubSpot integration.
HubSpot
Automate HubSpot CRM: manage contacts, companies, and deals with private app tokens.
Associate contact to company
Link a HubSpot contact record to a company.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
contact_id | string | Yes | HubSpot contact ID |
company_id | string | Yes | HubSpot company ID |
association_type | number | No | Numeric association type ID (1 for primary company) |
Response
{
"results": [
{
"fromObjectId": 123,
"fromObjectTypeId": "0-1",
"toObjectId": 456,
"toObjectTypeId": "0-2"
}
]
}Create a HubSpot company
Create a new HubSpot company record.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Company name |
domain | string | No | Company domain |
Response
{}Create a HubSpot contact
Create a new contact with email, name, phone, and company details.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
email | string | Yes | Contact email |
first_name | string | No | First name |
last_name | string | No | Last name |
phone | string | No | Phone number |
company | string | No | Company name |
Response
{}Create a HubSpot deal
Create a new deal with optional pipeline and stage.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
deal_name | string | Yes | Deal name |
amount | number | No | Deal amount |
pipeline | string | No | Pipeline ID |
stage | string | No | Stage ID |
Response
{}Find contact by email
Look up a HubSpot contact using an email address.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
email | string | Yes | Contact email to search for |
Response
{}List HubSpot contacts
List a limited set of HubSpot contacts for quick review.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
limit | number | No | Maximum contacts to return |
Response
{
"results": [
{
"id": "contact123",
"properties": {
"email": "user@example.com"
}
}
]
}Update a HubSpot contact
Update one or more properties on an existing contact.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
contact_id | string | Yes | HubSpot contact ID |
properties | object | Yes | JSON object of properties to update |
Response
{}Update deal stage
Move a HubSpot deal to a new stage.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
deal_id | string | Yes | HubSpot deal ID |
stage | string | Yes | Target stage ID |
Response
{}