HubSpot Bulk Create

In this article

Overview

You can use this Snap to create data objects in bulk in HubSpot. Learn more: HubSpot APIs.

Overview (4).png

Prerequisites

None.

Support for Ultra Pipelines

Works in Ultra Pipelines.

Known Issues and Limitations

The HubSpot Bulk Create Snap can create only 100 records in a single execution.

Snap Views

Format

Type

Number of Views

Examples of Upstream and Downstream Snaps

Description

Input

Document

Min: 1

Max: 1

  • HubSpot Read

  • Mapper

  • Copy

A document containing details of the data object(s) to create.

Output

Document

Min: 0

Max: 1

  • Mapper

  • Copy

  • Email Sender

A document containing the details of the new object(s) including the entity IDs.

Error

Error handling is a generic way to handle errors without losing data or failing the Snap execution. You can handle the errors that the Snap might encounter when running the Pipeline by choosing one of the following options from the When errors occur list under the Views tab:

  • Stop Pipeline Execution: Stops the current Pipeline execution if the Snap encounters an error.

  • Discard Error Data and Continue: Ignores the error, discards that record, and continues with the remaining records.

  • Route Error Data to Error View: Routes the error data to an error view without stopping the Snap execution.

Learn more about Error handling in Pipelines.

Snap Settings

  • Asterisk ( * ): Indicates a mandatory field.

  • Suggestion icon (): Indicates a list that is dynamically populated based on the configuration.

  • Expression icon ( ): Indicates the value is an expression (if enabled) or a static value (if disabled). Learn more about Using Expressions in SnapLogic.

  • Add icon ( ): Indicates that you can add fields in the fieldset.

  • Remove icon ( ): Indicates that you can remove fields from the fieldset.

  • Upload icon ( ): Indicates that you can upload files.

Feild Name

Feild Type

Description

Label*

 

Default Value: HubSpot Bulk Create
Example: Bulk Create a Company

String

Specify a name for the Snap. If you have more than one of the same Snaps in the pipeline, you can modify this and create a unique name.

API Version*

 

Default Value: V3
Example: V4

Dropdown list

Select the version of the API to use for the pipeline. Available options include:

  • V3

  • V4

Category*

 

Default Value: N/A
Example: CRM

String/Suggestion

Select the application in which you are creating the data object.

Entity*

 

Default Value: N/A
Example: Companies

String/Suggestion

Select the data object to be created.

Action*

 

Default Value: N/A
Example: Create a batch of Companies

String/Suggestion

Select the action to be performed by the Snap.

Required Parameters

Use this field set to enable the Snap to perform a specific action.

Parameter*

 

Default Value: N/A
Example: company.id

String/Expression

Specify the names of the required parameters.

Value*

 

Default Value: N/A
Example: 1889

String/Expression

Specify the values for the required parameters. The data type of this field depends on the specified parameter.

Connection timeout*

 

Default Value: 30
Example: 30

Integer

Specify the connection timeout duration in seconds.

Number of retries*

 

Default Value: 0
Example: 3

Integer

Specify the maximum number of reconnections to make if a connection failure or timeout occurs.

Retry Interval*

 

Default Value: 0
Example: 10

Integer

Specify the time interval between connection attempts.

Retry policy

 

Default Value: Connection errors
Example: Connection and API limit exceeded errors (429)

Dropdown list

Choose the retry policy for connection and error responses. The available options are:

  • Connection errors: Select this option when the client fails to establish a secure connection to the server.

  • Connection and API limit exceeded errors (429): Select this option when the 10-second or daily limit is exceeded.

Snap Execution

 

Default Value: Execute only
Example: Validate & Execute

Dropdown list

Select one of the following three modes in which the Snap executes:

  • Validate & Execute: Performs limited execution of the Snap, and generates a data preview during Pipeline validation. Subsequently, performs full execution of the Snap (unlimited records) during Pipeline runtime.

  • Execute only: Performs full execution of the Snap during Pipeline execution without generating preview data.

  • Disabled: Disables the Snap and all Snaps that are downstream from it.

Troubleshooting

Error

Reason

Resolution

Error

Reason

Resolution

Examples

Create a batch of companies

The following example pipeline demonstrates how to create a batch of companies in the HubSpot Platform.

Bulk_Create_pipeline.png

Configure the JSON Generator Snap to create a JSON file with the new company details such as name, address, and website. Alternatively, you can use a CSV (CSV Generator) or XML (XML Generator). Also, if you already have a file with the company details, you can configure a File Reader Snap to read the company details. On validation, the Snap shows the JSON-generated data.

Configure the Mapper Snap to map the output details from the JSON Generator Snap to the corresponding fields in the HubSpot Platform.

On validation, the JSON input fields are mapped to the HubSpot entity fields.

Configure the HubSpot Bulk Create Snap with the Company Entity and Create a Batch of Companies Action.

On validation, the Snap creates a batch of companies with the configured data.

Downloads

  1. Download and import the pipeline into the SnapLogic®Platform.

  2. Configure Snap accounts, as applicable.

  3. Provide pipeline parameters, as applicable.

Snap Pack History


Related Content