In this article
Table of Contents |
---|
minLevel | 1 |
---|
maxLevel | 2 |
---|
absoluteUrl | true |
---|
|
Overview
You can use this Snap to delete data objects in bulk from HubSpot. Learn more: HubSpot APIs.
![Overview (7).png](https://docs-snaplogic.atlassian.net/wiki/download/thumbnails/3073867842/Overview%20(7).png?version=1&modificationDate=1715274078928&cacheVersion=1&api=v2&width=502)
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 | | | A document with key/identifier of the data object(s) to delete. |
Output | Document | | | 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 ( ): 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 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 Value: V3 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 Value: Execute 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_uuid | 386ec55d-edb1-4bf2-80f2-ed7891a47dff |
---|
name | Troubleshooting_missing_required_parameters |
---|
templateData | eJyLjgUAARUAuQ== |
---|
page | HubSpot Create |
---|
addpanel | false |
---|
|
| Multiexcerpt fast include block macro |
---|
macro_uuid | 6703ac8b-4036-40cc-b4dd-f7ce9184f2a0 |
---|
name | Troubleshooting_missing_reqd_params_reason |
---|
templateData | eJyLjgUAARUAuQ== |
---|
page | HubSpot Create |
---|
addpanel | false |
---|
|
| Multiexcerpt fast include block macro |
---|
macro_uuid | 3d6c1306-48c8-4570-b4a8-fdd9518f2a63 |
---|
name | Troubleshooting_missing_reqd_params_resolution |
---|
templateData | eJyLjgUAARUAuQ== |
---|
page | HubSpot Create |
---|
addpanel | false |
---|
|
|
Multiexcerpt fast include block macro |
---|
macro_uuid | 3fa9a37e-fb5e-4f9a-9a65-eede77e8cf9d |
---|
name | Troubleshooting_rolling_limit |
---|
templateData | eJyLjgUAARUAuQ== |
---|
page | HubSpot Create |
---|
addpanel | false |
---|
|
| Multiexcerpt fast include block macro |
---|
macro_uuid | 53dd1190-0909-47d6-af98-438b5111cbb5 |
---|
name | Troubleshooting_rolling_limit_reason |
---|
templateData | eJyLjgUAARUAuQ== |
---|
page | HubSpot Create |
---|
addpanel | false |
---|
|
| Multiexcerpt fast include block macro |
---|
macro_uuid | a1b27a7b-2df6-412d-a7c8-caff99ac65d3 |
---|
name | Troubleshooting_rolling_limit_resolution |
---|
templateData | eJyLjgUAARUAuQ== |
---|
page | HubSpot Create |
---|
addpanel | false |
---|
|
|
Multiexcerpt fast include block macro |
---|
macro_uuid | cd5f1deb-f07b-494c-bcd9-a68874db4637 |
---|
name | Troubleshooting_daily_limit |
---|
templateData | eJyLjgUAARUAuQ== |
---|
page | HubSpot Create |
---|
addpanel | false |
---|
|
| Multiexcerpt fast include block macro |
---|
macro_uuid | 75f8b371-a0c7-4d19-8a4c-1a7c14d9996a |
---|
name | Troubleshooting_rolling_limit_reason |
---|
templateData | eJyLjgUAARUAuQ== |
---|
page | HubSpot Create |
---|
addpanel | false |
---|
|
| Multiexcerpt fast include block macro |
---|
macro_uuid | 105a0f49-a7eb-4be0-beb8-74cb415e2ba8 |
---|
name | Troubleshooting_daily_limit_resolution |
---|
templateData | eJyLjgUAARUAuQ== |
---|
page | HubSpot Create |
---|
addpanel | false |
---|
|
|
Examples
Delete a batch of companies
The following example pipeline demonstrates how to delete the batch of companies in HubSpot.
![Bulk_Delete_pipeline.png](https://docs-snaplogic.atlassian.net/wiki/download/thumbnails/3073867842/Bulk_Delete_pipeline.png?version=1&modificationDate=1706687633755&cacheVersion=1&api=v2&width=352)
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](https://docs-snaplogic.atlassian.net/wiki/download/thumbnails/3073867842/Bulk_Delete_pipeline_JSON_output.png?version=1&modificationDate=1706687673026&cacheVersion=1&api=v2&width=1009)
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](https://docs-snaplogic.atlassian.net/wiki/download/thumbnails/3073867842/Bulk_Delete_pipeline_mapping_table.png?version=1&modificationDate=1706687937907&cacheVersion=1&api=v2&width=1121)
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](https://docs-snaplogic.atlassian.net/wiki/download/thumbnails/3073867842/Bulk_Delete_pipeline_mapper_output.png?version=1&modificationDate=1706688859950&cacheVersion=1&api=v2&width=1009)
Configure the HubSpot Bulk Delete Snap with the Companies Entity and Archive a Batch of Companies by ID Action.
Image Removed
Image AddedOn validation, the Snap deletes the batch of companies.
![Bulk_Delete_pipeline_delete_output.png](https://docs-snaplogic.atlassian.net/wiki/download/thumbnails/3073867842/Bulk_Delete_pipeline_delete_output.png?version=1&modificationDate=1706689035255&cacheVersion=1&api=v2&width=1006)
Downloads
Info |
---|
Download and import the Pipeline into SnapLogic®. Configure Snap accounts, as applicable. Provide Pipeline parameters, as applicable.
|
Attachments |
---|
patterns | *.slp, *.zip |
---|
sortBy | name |
---|
|
Snap Pack History
Multiexcerpt include macro |
---|
macro_uuid | 8d63e18e-5118-4b0f-9d62-01b20c006711 |
---|
name | HubSpot_SPH |
---|
templateData | eJyLjgUAARUAuQ== |
---|
page | HubSpot Snap Pack |
---|
addpanel | false |
---|
|
Related Content