Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

In this article

Table of Contents
minLevel1
maxLevel2
absoluteUrltrue

Overview

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

Overview (7).png

Prerequisites

None.

Support for Ultra Pipelines

Works in Ultra Pipelines.

Known Issues and Limitations

None.

Snap Views

Type

Format

Number of Views

Examples of Upstream and Downstream Snaps

Description

Input 

Document

  • Min: 0

  • Max: 1

  • HubSpot Read

  • Mapper

  • Copy

A document with key/identifier of the data object(s) to delete.

Output

Document

  • Min: 0

  • Max: 1

  • Mapper

  • Copy

  • Email Sender

A document with the entity ID(s) and the status of the delete operation

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

Info
  • Asterisk (*): Indicates a mandatory field.

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

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

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

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

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

Field Name

Field Type

Description

Label*

Default Value: HubSpot Bulk Delete

Example: Bulk Delete Companies

String

The 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.

API Version*

Default ValueV3
Example: V4

Dropdown list

Select the version of the API that you use for the pipeline.

Category*

Default Value: N/A
Example: CRM

String

Select the application in which you delete the data objects.

Entity*

Default Value: N/A
Example: Companies

String

Select the data object to be deleted.

Action*

Default Value: N/A
Example: Archive a batch of companies by ID

String

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

Specify the names of the required parameters.

Value*

Default Value: N/A Example: 1885

Multiple

Specify the values for 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

IInteger

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

Retry interval (seconds)*

Default Value: 0

Example: 10

Integer

Specify the minimum number of seconds for which the Snap must wait before attempting recovery from a network failure.

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

Multiexcerpt fast include block macro
macro_uuid386ec55d-edb1-4bf2-80f2-ed7891a47dff
nameTroubleshooting_missing_required_parameters
templateDataeJyLjgUAARUAuQ==
pageHubSpot Create
addpanelfalse
Multiexcerpt fast include block macro
macro_uuid6703ac8b-4036-40cc-b4dd-f7ce9184f2a0
nameTroubleshooting_missing_reqd_params_reason
templateDataeJyLjgUAARUAuQ==
pageHubSpot Create
addpanelfalse
Multiexcerpt fast include block macro
macro_uuid3d6c1306-48c8-4570-b4a8-fdd9518f2a63
nameTroubleshooting_missing_reqd_params_resolution
templateDataeJyLjgUAARUAuQ==
pageHubSpot Create
addpanelfalse
Multiexcerpt fast include block macro
macro_uuid3fa9a37e-fb5e-4f9a-9a65-eede77e8cf9d
nameTroubleshooting_rolling_limit
templateDataeJyLjgUAARUAuQ==
pageHubSpot Create
addpanelfalse
Multiexcerpt fast include block macro
macro_uuid53dd1190-0909-47d6-af98-438b5111cbb5
nameTroubleshooting_rolling_limit_reason
templateDataeJyLjgUAARUAuQ==
pageHubSpot Create
addpanelfalse
Multiexcerpt fast include block macro
macro_uuida1b27a7b-2df6-412d-a7c8-caff99ac65d3
nameTroubleshooting_rolling_limit_resolution
templateDataeJyLjgUAARUAuQ==
pageHubSpot Create
addpanelfalse
Multiexcerpt fast include block macro
macro_uuidcd5f1deb-f07b-494c-bcd9-a68874db4637
nameTroubleshooting_daily_limit
templateDataeJyLjgUAARUAuQ==
pageHubSpot Create
addpanelfalse
Multiexcerpt fast include block macro
macro_uuid75f8b371-a0c7-4d19-8a4c-1a7c14d9996a
nameTroubleshooting_rolling_limit_reason
templateDataeJyLjgUAARUAuQ==
pageHubSpot Create
addpanelfalse
Multiexcerpt fast include block macro
macro_uuid105a0f49-a7eb-4be0-beb8-74cb415e2ba8
nameTroubleshooting_daily_limit_resolution
templateDataeJyLjgUAARUAuQ==
pageHubSpot Create
addpanelfalse

Examples

Delete a batch of companies

The following example pipeline demonstrates how to delete the batch of companies in HubSpot.

Bulk_Delete_pipeline.png

Configure the JSON Generator Snap to provide the company name as input to delete the specific companies. On validation, you can view the JSON output in the output preview.

Bulk_Delete_pipeline_JSON_output.png

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

Bulk_Delete_pipeline_mapping_table.png

Validate the Mapper Snap. The JSON input fields are mapped to the HubSpot entity's fields, as shown below:

Bulk_Delete_pipeline_mapper_output.png

Configure the HubSpot Bulk Delete Snap with the Companies Entity and Archive a Batch of Companies by ID Action.

Bulk_Delete_pipeline_bulkdelete.pngImage RemovedBulk delete.pngImage Added

On validation, the Snap deletes the batch of companies.

Bulk_Delete_pipeline_delete_output.png

Downloads

Info
  1. Download and import the Pipeline into SnapLogic®.

  2. Configure Snap accounts, as applicable.

  3. Provide Pipeline parameters, as applicable.

Attachments
patterns*.slp, *.zip
sortByname

Snap Pack History

Multiexcerpt include macro
macro_uuid8d63e18e-5118-4b0f-9d62-01b20c006711
nameHubSpot_SPH
templateDataeJyLjgUAARUAuQ==
pageHubSpot Snap Pack
addpanelfalse


Related Content