Error: "This authentication can no longer be used because more than 5 Salesforce authentications were created. Please use a different one."

Issue Summary: 

You have a couple of workflows which use different Authentications for Salesforce. After creating a new Salesforce Auth, some of your existing workflows start failing, and the output logs show the error in the title. 

Q1: We've heard there is a limit of 5 connections for one set of OAuth credentials for Salesforce. Is that true?

Yes, this is true. However, this is not a limit imposed by Tray.

Who imposes the 5 authentication limit?

The 5 authentication limit is imposed by Salesforce on their account. You can create as many Salesforce authentications in your Tray account as you would like. 

The Salesforce documentation says, "Each connected app allows five unique approvals per user. After a fifth approval is made, the oldest approval is revoked." (See this link for more information about how to Manage OAuth-Enabled Connected Apps Access to Your Data as described by Salesforce).

Depending on the nature of your Salesforce account, if you exceed the limit of your allowance, some of your authentications that may be saved in Tray may become deprecated on the Salesforce end. This is a common issue our customers face when building out Salesforce integration. 

A common example scenario

Say you have 5 SFDC credentials, each linked to an auth created in Tray:

• Salesforce 1
• Salesforce 2
• Salesforce 3
• Salesforce 4
• Salesforce 5

All of these will work. If your team mate X, decides to create a test workflow and creates a new authentication in Tray 'Salesforce 6', this creates a new authentication on the Salesforce end. Since Salesforce imposes a limit, they will invalidate the oldest credentials (Salesforce 1). Any workflows that were using Salesforce 1 will fail to connect to Salesforce. So, Tray facilitates the creation of authentications and surfaces Salesforce's error messages; however, we do not impose the limit on our end.

For embedded customers:
If you allow all your end-users to use your 'Salesforce 3 auth', then this shouldn't be a problem. If each of your end-users has their own SFDC account to integrate (and their auth is one of the most recent 5 auths on their Salesforce account), this also shouldn't be a problem. Any time a user exceeds the 5 auth allowance on their own Salesforce account, they will need to log in to Salesforce and manage their authentications there. 

You can typically do this via the SFDC menu: Platform Tools -> Apps -> Connected Apps OAuth Usage -> click on "User Count" for Tray.io. Please contact Salesforce for further assistance on this.