HubSpot

Read and write CRM contacts, companies, and deals via a Private App token

Credentials form9 toolshttps://api.hubapi.com

GET

hubspot_list_contacts

List CRM contacts, optionally selecting specific properties

/crm/v3/objects/contacts

4 parameters

Param	Type	Required	Description
limit	integer	optional	Number of results per page (max 100)
after	string	optional	Pagination cursor from a previous response
properties	string	optional	Comma-separated property names to include, e.g. 'email,firstname'
archived	boolean	optional	Return only archived (deleted) contacts

GET

hubspot_get_contact

Get a single CRM contact by ID (or by email/other unique idProperty)

/crm/v3/objects/contacts/{contact_id}

3 parameters

Param	Type	Required	Description
contact_id	string	required	Contact ID, or the value of idProperty if set
properties	string	optional	Comma-separated property names to include, e.g. 'email,firstname'
idProperty	string	optional	Property to look contact_id up by instead of the internal ID, e.g. 'email'

POST

hubspot_create_contact

Create a new CRM contact

/crm/v3/objects/contacts

1 parameter

Param	Type	Required	Description
properties	object	required	Contact property name/value pairs, e.g. { email: 'a@b.com', firstname: 'Ada' }

PATCH

hubspot_update_contact

Update (patch) specific properties on an existing contact

/crm/v3/objects/contacts/{contact_id}

2 parameters

Param	Type	Required	Description
contact_id	string	required	Contact ID to update
properties	object	required	Property name/value pairs to update, e.g. { lifecyclestage: 'customer' }

POST

hubspot_search_contacts

Search contacts using HubSpot's CRM search filter syntax

/crm/v3/objects/contacts/search

6 parameters

Param	Type	Required	Description
query	string	optional	Free-text search query across default properties
filterGroups	array	optional	OR'd groups of AND'd filters, e.g. [{ filters: [{ propertyName: 'email', operator: 'EQ', value: 'a@b.com' }] }]
properties	array	optional	Property names to include in each result
sorts	array	optional	Sort specs, e.g. ['-createdate']
limit	integer	optional	Number of results per page (max 100)
after	string	optional	Pagination cursor from a previous response

GET

hubspot_list_companies

List CRM companies, optionally selecting specific properties

/crm/v3/objects/companies

3 parameters

Param	Type	Required	Description
limit	integer	optional	Number of results per page (max 100)
after	string	optional	Pagination cursor from a previous response
properties	string	optional	Comma-separated property names to include, e.g. 'name,domain'

POST

hubspot_create_company

Create a new CRM company

/crm/v3/objects/companies

1 parameter

Param	Type	Required	Description
properties	object	required	Company property name/value pairs, e.g. { name: 'Acme', domain: 'acme.com' }

GET

hubspot_list_deals

List CRM deals, optionally selecting specific properties

/crm/v3/objects/deals

3 parameters

Param	Type	Required	Description
limit	integer	optional	Number of results per page (max 100)
after	string	optional	Pagination cursor from a previous response
properties	string	optional	Comma-separated property names to include, e.g. 'dealname,amount,dealstage'

POST

hubspot_create_deal

Create a new CRM deal

/crm/v3/objects/deals

1 parameter

Param	Type	Required	Description
properties	object	required	Deal property name/value pairs, e.g. { dealname: 'New Deal', pipeline: 'default', dealstage: 'appointmentscheduled', amount: '5000' }