HubSpot Contact Create Block | Scout

The HubSpot Contact Create block allows users to add new contacts to their HubSpot CRM directly from within a Scout workflow. This block leverages the HubSpot API to create a contact with detailed information such as email, name, phone number, and address. It supports dynamic data insertion using Jinja templating, ensuring that contact details are accurately rendered based on the workflow context.

Configuration (Required)

HubSpot Access Token

stringRequired

Use Environment Variables to safely and securely access sensitive credentials in a Scout workflow.

The access token used to authenticate with the HubSpot API. This token must have the necessary permissions to create contacts.

Contact Email

stringRequired

The email address of the contact to be created. This field is required and supports Jinja templating for dynamic data insertion.

First Name

string

The first name of the contact. This field is optional and defaults to an empty string if not provided. Supports Jinja templating.

Last Name

string

The last name of the contact. This field is optional and defaults to an empty string if not provided. Supports Jinja templating.

Phone Number

string

The phone number of the contact. This field is optional and defaults to an empty string if not provided. Supports Jinja templating.

Company Name

string

The company name associated with the contact. This field is optional and defaults to an empty string if not provided. Supports Jinja templating.

Job Title

string

The job title of the contact. This field is optional and defaults to an empty string if not provided. Supports Jinja templating.

Website URL

string

The website URL associated with the contact. This field is optional and defaults to an empty string if not provided. Supports Jinja templating.

Address

string

The address of the contact. This field is optional and defaults to an empty string if not provided. Supports Jinja templating.

City

string

The city where the contact is located. This field is optional and defaults to an empty string if not provided. Supports Jinja templating.

State

string

The state where the contact is located. This field is optional and defaults to an empty string if not provided. Supports Jinja templating.

ZIP Code

string

The ZIP code of the contact’s location. This field is optional and defaults to an empty string if not provided. Supports Jinja templating.

Country

string

The country where the contact is located. This field is optional and defaults to an empty string if not provided. Supports Jinja templating.

See Workflow Logic & State > State Management for details on using dynamic variables in this block.

Outputs

The block returns the response from the HubSpot API after attempting to create a contact. The response includes the contact details or an error message if the creation failed.

Usage Context

Use this block when you need to create new contacts in HubSpot CRM as part of your workflow. This is particularly useful for integrating CRM management within automated processes.

Best Practices

Ensure that the HubSpot Access Token is valid and has the necessary permissions to create contacts.
Use Jinja templating to dynamically fill contact details based on workflow context.
Validate email addresses and other contact details before sending them to HubSpot to prevent errors.
Handle potential API exceptions gracefully to ensure workflow robustness.