Understanding your Integration

This article will help you understand the status of your integration and how to resolve any errors preventing it from syncing successfully.


Table of Contents


Lead Integration Status

Setup Incomplete

This one pretty much speaks for itself!  Further detail on this state can be viewed within the lead source setup tracker. If your integration has not moved to the Active state even after you received an expected test lead, check these steps:

  • You may need to hit the "complete setup" button in the integration. At this time, the setup does not complete automatically when leads are received
  • If you are unable to "complete setup", the test lead may not have the exact expected source value--in which case a revision should be requested by the lead partner. 

Active

Your integration will appear as Active once a lead has been received with the expected source value and a user has completed the setup flow. 

One distinction that needs to be made is that this status is not dynamic: it only reflects that the lead integration was at one point successfully activated, and does not reflect any subsequent errors or changes that may occur on the lead partner's side.

CRM Integration Status

Setup Incomplete

This one pretty much speaks for itself! We see this on occasion if:

  • Your org's Manager needed some more information to complete setup at a later time
  • Your org's Manager never hit the "Finish" button after authorizing
  • Someone clicked an integration setup by mistake or out of curiosity, and never deleted it

Active

If your Integration is in the Active state, you should have nothing to worry about! This is the expected status indicating your integration is in a healthy state.

An Active state does not necessarily mean the integration will never have an error or failed sync (these are naturally expected when working with APIs!), but they should be infrequent and may even resolve themselves due to our automated failure retry system.

Failed Sync

 A failed sync may be nothing to worry about--these things happen sometimes!  It just means the last attempted sync had some error or failure, and our retry system will keep attempting until it succeeds. 

However, if your integration is experiencing a regular state of failure or you notice information is missing, you may want to check with our Support Team to take a closer look. 

Paused

Your integration may become paused in two ways: manually (by user action) or automatically (by our validation process).

Our validation process evaluates if the integration meets certain requirements in regards to the authorization provided and/or necessary permissions to use the source API. These differ for each integration (we will go into more detail in the next section). 

If your integration has failed the validation checks, it may result in one of these statuses that fall under the Paused category:

  • Expired Credentials - This state indicates that your integration has been paused as a result of invalid credentials. You may also have received an email and/or an in-app notification alerting you to this status.

How to Resolve CRM Validation Errors

These errors vary somewhat from CRM to CRM. We will review them individually here.

As always, feel free to reach out to our Support Team for assistance resolving these errors!