HubSpot Create
Overview
Use this Snap to create data objects in HubSpot. For more information about HubSpot APIs, see HubSpot Documentation.
Prerequisites
None.
Support for Ultra Pipelines
Works in Ultra Pipelines.
See Snap Support for Ultra Pipelines.
Limitations
None.
Known Issues
None.
Snap Views
Type | Format | Number of Views | Examples of Upstream and Downstream Snaps | Description |
---|---|---|---|---|
Input | Document |
|
| A document containing details of the data object to create. |
Output | Document |
|
| A document containing the details of the new object 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:
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.
Field Name | Field Type | Description | |
---|---|---|---|
Label*
Default Value: HubSpot Create | 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. | |
Entity*
Default Value: Association | String | Select the data object to create. | |
Action*
Default Value: N/A | String | Select the create-action to perform on the entity selected above. Click the Suggestion icon to see the list of supported actions. | |
Required Parameters
| Use this field set to enable the Snap to perform a specific action. | ||
Parameter Default Value: N/A | String | Specify the names of the required parameters. Click the Suggestion icon to see the list of supported parameters. | |
Value
Default Value: N/A | Multiple | Specify the values of the required parameters. The data type of this field depends on what parameter name you selected or entered which can be String, Integer, Boolean, etc. | |
Connection timeout*
Default Value: 30 | Integer | Specify the connection timeout duration in seconds. | |
Number of retries*
Default Value: 0 | Integer | Specify the maximum number of reconnections to make if a connection failure or timeout occurs. | |
Retry interval (seconds)*
Default Value: 0 | Integer | Specify the time interval between connection attempts. | |
Retry policy
Default Value: Connection errors | Dropdown list | Choose the retry policy for connection and error responses. The available options are:
| |
Snap Execution
Default Value: Execute only | Dropdown list | Select one of the following three modes in which the Snap executes:
|
Troubleshooting
Error | Reason | Resolution |
---|---|---|
Missing required parameters. | There is a required parameter that was not provided. | Verify whether all required parameters are configured. |
You have reached your ten secondly rolling limit. | There are too many requests to REST endpoint. | Select Connection and API limit exceeded (429) errors in the Retry Policy and adjust the values for “Number of retries” and “Retry interval”. |
You have reached your daily limit. | There are too many requests to REST endpoint. | The maximum number of daily requests has been reached, and no further requests can be made until it resets. For more information refer to API Meters. |
Examples
Creating a new company in HubSpot
We want to create a company in the HubSpot instance. This Pipeline demonstrates how we can use the HubSpot Create Snap to accomplish this task:
First, we use the JSON Generator Snap to create a JSON file containing the new entity's details such as name, city, and about_us. 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 Create Snap. The HubSpot Create Snap is configured with the Company entity and Create a company action.
Upon execution, the HubSpot Create Snap creates a company with the specified details as shown in the HubSpot Create 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 Create Snap. The screenshot below shows the configuration of the File Writer Snap:
To view the newly-created file, you must SSH to the target directory and open the newly-created file.
Downloads
Download and import the Pipeline into SnapLogic.
Configure Snap accounts as applicable.
Furnish Pipeline parameters as applicable.
See Also
Have feedback? Email helpdesk@rojoconsultancy.com © Rojo Consultancy