HubSpot Contact

Description

The HubSpot Contact entity represents individuals (leads or customers) stored in your HubSpot CRM. Each contact includes personal and business information such as name, email, phone number, associated company, and address details.

This activity enables workflows to manage contact records automatically, supporting single and bulk operations like create, update, retrieve, or delete. It also allows data mapping from previous activities for dynamic contact creation.

Use this activity to:

• Get – Fetch a specific contact by ID.
• Get All – Retrieve all HubSpot contacts.
• Create – Add a new contact with personal and professional details.
• Create Many – Add multiple contacts from previous workflow data using field mappings.
• Update – Modify an existing contact using its ID.
• Delete – Remove a contact using its ID.

Use Case: In a sales workflow, leads collected via web forms or Excel files can be read using the ReadCsv activity and directly created or updated in HubSpot using HubSpotContact. After enriching the data, FilterOnValue can segment leads by country or interest. These filtered contacts can then be associated with deals or exported to other tools like Google Sheets for marketing or CRM syncing

Input

• Data – Required for Create Many.

Output

Output Type	Format	Description
Data	JSON	HubSpot Contact record(s) output

Configuration Fields

Field Name	Description
Connection	OAuth-based HubSpot connection. Required for all operations.
Operation	Choose from: Get Get All Create Create Many Update Delete
Id	Used in Get, Update, and Delete. Provide the HubSpot Contact ID.
firstname	First name of the contact. Required for Create and Update.
lastname	Last name of the contact.
email	Email address of the contact.
mobilephone	Mobile phone number.
associatedcompanyid	ID of the associated HubSpot company.
jobtitle	Contact’s job title.
address	Address of the contact.
city	City of the contact.
state	State or region.
zip	Zip or postal code.
country	Country of the contact.
Additional Fields	Custom user-defined fields for Create, Update.
Config Fields Mapping	Field mappings for input data in Create Many.
Additional Fields Mapping	Custom field mappings for Create Many.

Sample Input

Operation	Required Fields	Example
Get	Id	Id: 123456700000001
Get All	None	(No input required)
Create	Contact fields	firstname: John, lastname: Doe, email: john@example.com, city: New York, jobtitle: Manager
Update	Id, fields to update	Id: 123456700000001, jobtitle: Senior Manager, city: Los Angeles
Delete	Id	Id: 123456700000001
Create Many	Field Mappings	ConfigFieldsMapping: { firstname → FirstName, email → EmailAddress, city → Location }, AdditionalFieldsMapping: { jobtitle → Role }

Input fields for Create Many operation are mapped from data output by the previous activity in the workflow.

Sample Configuration

Field	Value
connection.id	hubspot-conn-001
operation	CreateMany
ConfigFieldsMapping	firstname → FirstName, email → EmailAddress, city → Location
AdditionalFieldsMapping	jobtitle → Role

Sample Output

Id	First Name	Last Name	Email	City	Job Title	Created Time
12345678	John	Doe	john@example.com	New York	Manager	2024-06-19T09:30:00Z
12345679	Jane	Smith	jane@example.com	San Jose	Product Lead	2024-06-19T09:45:10Z