In this article

Overview

Use this Snap to delete entities from the HubSpot instance. 

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: 0
  • Max: 1
  • HubSpot Read
  • Mapper
  • Copy
A document containing key/identifier of the data object to delete.
Output

Document

  • Min: 0
  • Max: 1
  • Mapper
  • Copy
  • Email Sender
A document containing the entity ID and the status of the delete operation.

Snap Settings


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


Examples

Delete a Company from HubSpot

We want to delete a company from the HubSpot instance. This Pipeline demonstrates how we can use the HubSpot Delete Snap to accomplish this task:

We do not need any Snap other than the HubSpot Delete Snap to delete an entity. However, we want to write the delete confirmation output by the HubSpot Delete Snap into a local JSON file. That is why we use the JSON Formatter and File Writer Snap in this example. If there are multiple entities to delete, we can pass the entities' identifier through upstream Snaps or as a Pipeline parameter. In that case, we can add Snaps such as Mapper, File Reader, or Copy, upstream of the HubSpot Delete Snap.

We configure the HubSpot Delete Snap with the Company entity and Delete a company action. We also provide the entity's identifier (company_id) as a required parameter.

Upon execution, the HubSpot Delete Snap deletes the specified entity and outputs a confirmation of the same.

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 Delete 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