In this article

Overview

Use this Snap to update the details of an entity in the HubSpot instance.

Prerequisites

None.

Support for Ultra Pipelines

Works in Ultra Pipelines. 

Limitations

None.

Known Issues

None.

Snap Input and Output

Snap Settings

Parameter Name	Data Type	Description	Default Value	Example
Label	String	Specify a name for the Snap. You can modify this to be more specific, especially if you have more than one of the same Snap in your pipeline.	HubSpot Create	Create a Company
Entity	String	Required. Select the data object to update.	Association	Company
Action	String	Required. Select the update-action to perform on the entity selected above. Click  to see the list of supported actions.	N/A	Update a company
Required parameter	Specify the required fields for a specific action. Specify each parameter in a separate row. Click  to add a new row. This fieldset consists of the following fields:  Parameter Value
Parameter	String	Specify the names of the required parameters. Click  to see the list of supported parameters.	N/A	table_id
Value	Multiple	Specify the values of the required parameters. The data type of this field depends on the specified parameter.	N/A	123561234
Connection timeout	Integer	Required. Enter the connection timeout duration of seconds.	30	30
Number of retries	Integer	Required. Enter the maximum number of re-connection attempts in case of a failure or timeout.	0	3
Retry interval (seconds)	Integer	Required. Enter the interval in seconds between reconnection attempts.	0	10
Retry policy	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.	Connection errors	Connection and API limit exceeded errors (429)
Snap Execution	String	Indicates how the Snap must be executed. Available options are: Validate & Execute: Performs limited execution of the Snap (up to 50 records) during Pipeline validation; performs full execution of the Snap (unlimited records) during Pipeline execution. Execute only: Performs full execution of the Snap during Pipeline execution; does not execute the Snap during Pipeline validation. Disabled: Disables the Snap and, by extension, its downstream Snaps.	Execute only	Validate & Execute

Troubleshooting

Examples

Update a Company in HubSpot

We want to update a company entity in the HubSpot instance. This Pipeline demonstrates how we can use the HubSpot Update Snap to accomplish this task:

First, we use the JSON Generator Snap to create a JSON file containing the entity's updated details such as country, founded_year, and address. It is not necessary to use a JSON input, we can also use CSV (CSV Generator) and XML (XML Generator). Alternatively, we can use a File Reader Snap if we already have a file with the company's details and configure it to read the company details file. 

The screenshot below shows the output from the JSON Generator Snap:

We map the fields from the output shown above to the corresponding fields in HubSpot using the Mapper Snap. 

Upon execution, the JSON input file's fields are mapped to the HubSpot entity's fields as shown in the Mapper Snap's output below:

The above output is passed to the HubSpot Update Snap. The HubSpot Update Snap is configured with the Company entity and Update a company action.

Upon execution, the HubSpot Update Snap updates the company with the specified details as shown in the HubSpot Update Snap's output below:

Since we want to write this output into a local file for record-keeping, we use a combination of the JSON Formatter and File Writer Snaps downstream of the HubSpot Update Snap.  The screenshot below shows the configuration of the File Writer Snap:

Download this pipeline from the Downloads section.

Downloads

See Also

• HubSpot API Reference
• Getting Started with SnapLogic
• Snap Support for Ultra Pipelines