Create or Update a HubSpot Contact from a Typeform Response

When someone completes your Typeform, this trigger captures all their responses and starts the workflow. You'll select which specific Typeform you want to monitor from your connected account. The trigger automatically passes all form field data (like name, email, company) to the next step using variables like `{{typeform.form_response.answers}}`. This data becomes available for mapping to your HubSpot contact properties.

This step searches your HubSpot contacts using the email address from the Typeform response. It's configured to look for an exact email match using the filter `{{typeform.form_response.answers.email}}` and returns up to 1 result. If a contact is found, the step passes their existing contact ID and properties to the next step. If no match is found, it returns empty results, which tells the workflow to create a new contact instead.

This conditional path triggers when the search finds an existing contact (when `{{hubspot.results[0].properties.email}}` is not empty). The path automatically inherits the contact ID from the search results and prepares it for the update step. All Typeform response data remains available for mapping to contact properties during the update process.

When an existing contact is found, this step updates their HubSpot record using the contact ID from `{{hubspot.results[0].id}}`. You'll map Typeform response fields to specific HubSpot contact properties, such as connecting `{{typeform.form_response.answers.company}}` to the "Company" field. The step preserves existing contact data while only updating the properties you specify, maintaining your contact history and relationships.

This conditional path triggers when the search returns empty results (when `{{hubspot.results[0].properties.email}}` is empty), indicating this is a new contact. The path receives all the original Typeform response data and prepares it for creating a fresh contact record. This ensures new leads are captured immediately without manual intervention.

When no existing contact is found, this step creates a new HubSpot contact record using the Typeform response data. You'll map form fields like `{{typeform.form_response.answers.first_name}}` to corresponding HubSpot properties such as "First Name" and "Email." The step automatically generates a new contact ID and sets the lifecycle stage and lead source, giving you a complete contact record for follow-up.