When users use any but the promoted version, they will see the version displayed and be able to manually update to the promoted version.

​
What happens after setting a version to deprecate

The deprecation date must be between 3 weeks and 1 year in the future. We won’t communicate the deprecation until 2 weeks before the deprecation date. This gives you time to migrate users to a newer version, before we start notifying them that they need to manually migrate.

​
1. Email notification

A notification email will be sent exactly 14 days before the configured deprecation date. This email includes the deprecation reason that newer versions of the Zapier CLI ask you for. We do recommend supplementing these automated messages by also notifying your general user base through in-app announcements or email marketing campaigns. For privacy reasons, Zapier cannot provide you with an email list of users of your integration.

​
2. Deprecation date reached

  • Zaps that haven’t been updated will be automatically paused.
  • A second email, titled “X Zaps paused over deprecated apps,” will be sent out to those users. Customizing this email is not possible.
  • Any attempts to test triggers or actions on the deprecated version will result in an error, and Zaps that use it cannot be enabled.
  • The deprecated version will be labelled as “Deprecated” in the Zap editor, with a prompt for users to update to the latest version.

​
3. Post-deprecation

After the deprecation date, the version will still be visible in the Versions page for your future reference. Users will not be able to see the version once they select a different version in their Zaps.

​
Deprecate a version with Platform UI

To deprecate an integration version:
  1. Log into the Platform UI.
  2. Select your integration.
  3. In the Manage section in the left sidebar, click Version.
  4. Click the three dot icon in line with the integration version you want to deprecate.
  5. Click Deprecate.
  6. In the dialog box, add the Deprecation Reason and Deprecation Date. You can set a deprecation date anytime between 3 weeks and 1 year from the current date. The deprecation reason will be used in user notifications.
  7. Click Deprecate.
  8. Click Close

​
Deprecate a version with Platform CLI

To deprecate an integration version use the command zapier deprecate. Learn more about Platform CLI commands.

​
Deleting deprecated versions

After your version has been deprecated, you have the option to delete versions entirely. Exercise this option with extreme caution. Deleting a version makes it permanently inaccessible, both to you and to your users. Deleted versions cannot be restored by Zapier Developer Support. Deletion should be a last resort, used only when you are certain that the version will never be needed again. Deletion is also only possible when 0 users remain on a version. The count of users on the Versions page includes live Zaps only. If you’re seeing the error Unable to delete app version, this can be caused by users on that version not included in the visible count (paused Zaps, app authentications for example).

​
We’re no longer supporting our integration and would like to remove it from the app listing. How can I unpublish the integration and deactivate it?

For any public integration, the first step is to revert that integration to private, which will prevent new users from seeing it in the Zapier App Directory or in the Zap editor. Once the integration is private, you can deprecate each version of that app (except the latest version, which will remain private if there are users still on the version). to deprecate an integration version, please follow the steps outlined above. If the product’s API endpoints will be shutdown, any users still using that now-private app in their Zaps, will begin to see errors when requests are made to those endpoints and their Zaps will eventually be turned off, no longer making requests. That said, if you want to proceed with this, please reach out to Developer Support and we’ll help you revert your integration to private so that you can proceed with the next steps. Need help? Tell us about your problem and we’ll connect you with the right resource or contact support.