---
title: Enabling Auto-unsubscribe
description: This article explains how the Auto-unsubscribe feature of the API functions and how to have it enabled
---

[Skip to content](https://support.vizionapi.com/migration/enabling-auto-unsubscribe#main-content)

English

Show submenu for translations

[Contact Support](https://support.vizionapi.com/migration/kb-tickets/new?hsLang=en) [Customer portal](https://support.vizionapi.com/tickets?hsLang=en)

![Master Vizion Logo File\_Updated April 2022\_Yellow-1.png\]](https://support.vizionapi.com/hs-fs/hubfs/Master%20Vizion%20Logo%20File_Updated%20April%202022_Yellow-1.png?height=40&name=Master%20Vizion%20Logo%20File_Updated%20April%202022_Yellow-1.png)

- [Default HubSpot Blog](https://vizionapi-8694848.hs-sites.com/blog)

Open main navigation

Close main navigation

- [Default HubSpot Blog](https://vizionapi-8694848.hs-sites.com/blog)
- English
  
  Show submenu for translations
- [Contact Support](https://support.vizionapi.com/migration/kb-tickets/new)
- [Customer portal](https://support.vizionapi.com/tickets)
- [Go to vizionapi.com](https://www.vizionapi.com/)

[Go to vizionapi.com](https://www.vizionapi.com/)

 How can we help?

- There are no suggestions because the search field is empty.

1. [Knowledge Base](https://support.vizionapi.com/migration?hsLang=en)
2. [Track containers](https://support.vizionapi.com/migration/track-containers?hsLang=en)

# Enabling Auto-unsubscribe

## This article explains how the Auto-unsubscribe feature of the API functions and how to have it enabled

### What is Auto-Unsubscribe?

The Vizion API will now detect the presence of a new shipment cycle and deactivate container tracking references automatically.

Auto-unsubscribe works in one of the following ways:

1. The API detects an actual "gate in empty return" event in the current journey's milestones
2. The API detects the start of a new container journey

**An actual "gate in empty return"**

If Auto-unsubscribe is enabled for the account, the API will check each reference's latest update for the inclusion of a "gate in empty return" milestone at the destination port. If one is found, the reference will be automatically unsubscribed or deactivated.

**The start of a new container journey**

If the latest reference update contains entirely different milestones that occurred later than the last available milestone in the previous update's milestone list, the API will determine that the container has started a new journey and automatically unsubscribe.

The Vizion API also utilizes logic for its own housekeeping that identifies references that are a few months old and have completed at least one journey. If there has been no new milestone activity or we detect a new container journey, our system will automatically unsubscribe from those references. This is true for all accounts regardless of Auto-unsubscribe.

### How do I enable Auto-Unsubscribe?

Auto-unsubscribe can be enabled for your account (on both Demo and Production environments of the API) as a part of a new or existing plan at no additional cost.

If you would like to have Auto-unsubscribe enabled, you only need to request it by writing in to [support@vizionapi.com](mailto:support@vizionapi.com)!

For users with [No-Code Work Books (NCWBs)](https://support.vizionapi.com/what-is-the-no-code-workbook?hsLang=en) using Google Sheets, Auto-Unsubscribe will still work to stop tracking your references based on the conditions above. However, it will not automatically remove containers from your workbook.

To remove containers from your workbook, you will still need to use the "Unsubscribe container" option in the Vizion Tools menu to delete them fully.

 

- [Getting started](https://support.vizionapi.com/migration/getting-started?hsLang=en)
- [Track containers](https://support.vizionapi.com/migration/track-containers?hsLang=en#main-content)

    - [Create reference via Bill of Lading](https://support.vizionapi.com/migration/track-containers?hsLang=en#create-reference-via-bill-of-lading)
    - [Create reference via Carrier Code](https://support.vizionapi.com/migration/track-containers?hsLang=en#create-reference-via-carrier-code)
    - [Create reference via Auto Carrier Identification](https://support.vizionapi.com/migration/track-containers?hsLang=en#create-reference-via-auto-carrier-identification)
    - [Troubleshooting](https://support.vizionapi.com/migration/track-containers?hsLang=en#troubleshooting)
    - [Create reference via Booking Number](https://support.vizionapi.com/migration/track-containers?hsLang=en#create-reference-via-booking-number)
- [Vizion data](https://support.vizionapi.com/migration/vizion-data?hsLang=en#main-content)

    - [Data sources](https://support.vizionapi.com/migration/vizion-data?hsLang=en#data-sources)
    - [ETAs](https://support.vizionapi.com/migration/vizion-data?hsLang=en#etas)
    - [Formatting](https://support.vizionapi.com/migration/vizion-data?hsLang=en#formatting)
- [Accounts and billing](https://support.vizionapi.com/migration/accounts-and-billing?hsLang=en#main-content)

    - [Usage](https://support.vizionapi.com/migration/accounts-and-billing?hsLang=en#usage)
    - [Technical support](https://support.vizionapi.com/migration/accounts-and-billing?hsLang=en#technical-support)
- [Integrations](https://support.vizionapi.com/migration/integrations?hsLang=en#main-content)

    - [No Code Workbook](https://support.vizionapi.com/migration/integrations?hsLang=en#no-code-workbook)
- [Tutorials](https://support.vizionapi.com/migration/tutorials?hsLang=en#main-content)

    - [Getting started](https://support.vizionapi.com/migration/tutorials?hsLang=en#getting-started)

- [Default HubSpot Blog](https://vizionapi-8694848.hs-sites.com/blog)

# Vizion Inc.

Vizion Knowledge Base

Copyright © 2026, Vizion Inc.