[HubSpot] Create/Update Contact
The [HubSpot] Create/Update Contact block writes contact records to HubSpot, either creating a new contact or updating an existing one depending on whether a match is found for the provided email address.
Create or update HubSpot contacts matched by email
The [HubSpot] Create/Update Contact block writes contact records to HubSpot, either creating a new contact or updating an existing one depending on whether a match is found for the provided email address. Email is the matching key — if a contact with that address already exists in HubSpot, its properties are updated; if not, a new contact record is created. The block connects to HubSpot via an OAuth connection ID, so no manual API key handling is required in the workflow.
The core contact input accepts an email address, first name, and last name, along with any additional HubSpot property values passed as key-value pairs. The enabledProperties field defines which properties are active and specifies their expected types — string, number, or boolean — so values are validated against those types before being sent to HubSpot. An optional companyDomain field can be provided to associate the contact with a company; if that company does not already exist in HubSpot, it will be created automatically.
When the block completes, it returns a contactId — the HubSpot internal ID of the created or updated contact — which can be stored in a workflow variable for use in downstream steps. This block fits naturally into lead capture workflows, form submission handlers, CRM sync pipelines, and any automation that needs to keep HubSpot contact data current based on user activity or external data sources.
What you can build
Real-world workflows powered by the [HubSpot] Create/Update Contact block.
Lead Capture Form Sync
When a user submits a lead form, pass their details to this block to create or update their HubSpot contact record automatically.
Onboarding CRM Registration
During a user onboarding flow, write the new user's contact information to HubSpot so sales and support teams have immediate visibility.
Event Registration Tracking
After a user registers for a webinar or event, create or update their HubSpot contact and associate them with the relevant company domain.
Sales Outreach Enrichment
Combine this block with data enrichment steps to write enriched contact properties — such as job title or industry — back into HubSpot.
Support Ticket Contact Sync
When a support ticket is submitted, ensure the submitter exists as a HubSpot contact so their record is linked to any follow-up activity.
E-commerce Customer Sync
After a purchase event, create or update the buyer's HubSpot contact record and associate them with their company domain for B2B tracking.
Ready to add [HubSpot] Create/Update Contact to your workflow?
Get Started FreeCommon questions about [HubSpot] Create/Update Contact
What are the required parameters for this block?
The block requires a HubSpot OAuth connection ID (connectionId) and a contact object that includes at minimum an email address, first name, and last name. The email field is used to match existing contacts in HubSpot.
What does the block return when it finishes?
The block outputs a contactId string, which is the HubSpot internal ID of the contact that was created or updated. This can be stored in a workflow variable using the destinationVar field for use in later steps.
What happens if a contact with the given email already exists in HubSpot?
If a contact with the provided email address already exists, the block updates that contact's properties rather than creating a duplicate. If no match is found, a new contact is created.
What is the companyDomain field used for?
If a companyDomain value is provided, the contact will be associated with that company in HubSpot. If the company does not already exist, it will be created automatically as part of the same operation.
What kinds of workflows commonly use this block?
This block is commonly used in lead capture pipelines, user onboarding flows, form submission handlers, e-commerce post-purchase automations, and any workflow that needs to keep HubSpot contact records synchronized with external data or user activity.
Related capabilities
[Hunter.io] Find Email
Find an email address for a specific person at a domain using Hunter.io.
[Hunter.io] Enrich Person
Look up professional information about a person by their email address using Hunter.io.
[Hunter.io] Verify Email
Verify whether an email address is valid and deliverable using Hunter.io.
[Hunter.io] Enrich Company
Look up company information by domain using Hunter.io.
[Hunter.io] Domain Search
Search for email addresses associated with a domain using Hunter.io.
[ActiveCampaign] Create Contact
Create or sync a contact in ActiveCampaign.
Add [HubSpot] Create/Update Contact to your workflow
Build powerful AI workflows with drag-and-drop blocks. No coding required.