In this article

Overview

Use this Snap to create entities in the HubSpot portal. 


Prerequisites

None.

Support for Ultra Pipelines

Works in Ultra Pipelines. 

Limitations

None.

Known Issues

None.

Snap Input and Output

Input/OutputType of ViewNumber of ViewsExamples of Upstream and Downstream SnapsDescription
Input 

Document

  • Min: 1
  • Max: 1
  • HubSpot Read
  • Mapper
  • Copy
A document containing details of the data object to create.
Output

Document

  • Min: 0
  • Max: 1
  • Mapper
  • Copy
  • Email Sender
A document containing the details of the new object including the entity IDs.

Snap Settings


Parameter NameData TypeDescriptionDefault ValueExample 
LabelString
HubSpot CreateCreate a Company
EntityStringRequired. Select the data object to create.AssociationCompany
ActionStringRequired. Select the create-action to perform on the entity selected above. Click  to see the list of supported actions. N/ACreate 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

StringSpecify the names of the required parameters. Click  to see the list of supported parameters.N/A

table_id

ValueMultipleSpecify the values of the required parameters. The data type of this field depends on the specified parameter.N/A

123561234

Connection timeoutIntegerRequired. Enter the connection timeout duration of seconds.3030
Number of retriesIntegerRequired. Enter the maximum number of re-connection attempts in case of a failure or timeout.03
Retry interval (seconds)IntegerRequired. Enter the interval in seconds between reconnection attempts.010

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 errorsConnection and API limit exceeded errors (429)
Snap ExecutionString

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 onlyValidate & Execute

Troubleshooting

ErrorReasonResolution


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 errors (429) 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 HubSpot Documentation.


Examples

Create a 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:

Download this pipeline. 

Downloads

  1. Download and import the Pipeline into SnapLogic.
  2. Configure Snap accounts as applicable.
  3. Provide Pipeline parameters as applicable.




See Also