CRMJettyBack to crmjetty.comContact us
Menu
Docs / Guides

CRMJetty Portal

Works with
Docs / Dynamics 365

Dynamics 365 Customer Portalv6.3.0

Docs / Salesforce

Salesforce Customer Portalv6.3.0

Docs / Business Central

Business Central Portal

Guides / CRM connection and sync

How to Fix CRM Connection Errors in CRMJetty Portal

6 min readUpdated
Short answerOpen CRM Authentication (Business Central Authentication for Business Central), select Test Connection and check the status. If it shows Not connected, re-enter the connection details for the selected Environment, check for an expired client secret, certificate or changed security token, save and test again.

When the portal can’t reach your CRM, Test Connection shows Not connected and the portal can’t read or write CRM data. Most connection errors come from details entered for the wrong environment, an expired secret or certificate, or a missing permission in your CRM. This article lists the known causes for each system and where to fix them.

Before you start

Check the connection status

  1. Sign in to the admin portal.
  2. Go to Settings → Portal Settings → CRM Authentication. For Business Central, go to Settings → Portal Settings → Business Central Authentication.
  3. Enter the OTP sent to the super admin’s registered email address.
  4. Select Test Connection.
  5. Check the connection status on the right side of the page.
Status What it means
Connected A success message appears. The portal can use your CRM data.
Not connected The portal could not connect with the details entered. Work through the sections below.

Check the connection details for your system

Each system uses different fields. Check every value against its source, and check that all of them belong to the environment selected in Environment (Live or Sandbox).

System Fields to check Where the values come from
Dynamics 365 Service URL, App ID, Client Secret How to Register an Entra ID App for Dynamics 365 OAuth
Salesforce The connected app values and the Salesforce user details How to Find Your Salesforce Consumer Key and Secret
Business Central Client ID, Client Secret, Tenant ID How to Connect Business Central to CRMJetty Portal

For Salesforce, the Environment field is called Mode in older versions.

After you correct a value, select Save, then Test Connection again. If it still fails, ask the person who manages your CRM or Business Central to confirm the details.

Problems on every system

You don’t receive the OTP: Only the super admin receives the OTP, at their registered email address. Sign in as the super admin and check that SMTP is configured and a test email arrives. See How to Configure SMTP Email in CRMJetty Portal.

Test Connection fails after you switch between Sandbox and Live: The details still belong to the previous environment. Enter the details for the environment selected in Environment, select Save and test again. See How to Switch the Portal Between Sandbox and Live CRM.

You can’t enable entities in Entity Configurations (Business Central: Table Configurations): Entities and tables can be enabled only after the CRM connection succeeds. Fix the connection first. See How to Enable CRM Entities and Custom Objects in the Portal.

Portal data updates slowly at busy times: This is usually not a connection error. Your CRM may be throttling API calls. See CRM API Limits and Portal API Usage Explained.

Important: If you change the connected CRM, or its Service URL or organization, the portal asks you to choose Preserve Data or Reset Data. Reset Data removes all pages, forms, lists, templates and site configuration. Read How to Preserve or Reset Portal Data After Reconnecting before you reconnect a portal that is in use.

Problems after reconnecting

Widgets show no data after Preserve Data: Widgets with CRM-based settings, such as Recent Activities, Counters and Data Cards, still point to the old CRM. Edit each widget and select the entities and fields from the new CRM.

Portal users can’t sign in after reconnecting: Portal access is removed from existing contacts when you connect a new CRM. Enable the portal users again and generate credentials. See How to Generate Portal Login Credentials in Bulk.

Dynamics 365 problems

The connection fails after it worked before: The client secret may have expired. Create a new secret in Certificates & secrets in Microsoft Entra ID (formerly Azure Active Directory), then update Client Secret in the portal. See Create a client secret.

You can’t find the client secret value: The value is shown only when you create it. Create a new client secret and copy the value.

The CRMJetty solution does not appear in the Solutions list: The import did not finish. Sign in to Dynamics 365 as an admin and import the zip file again. See How to Install the CRMJetty Solution in Dynamics 365.

Salesforce problems

The portal can’t connect right after you create the connected app: Salesforce can take a few minutes to activate a new connected app. Wait, then test the connection again.

The connection is refused for the portal’s Salesforce user: Check that the user’s profile is added under Manage Profiles on the connected app, and that Permitted Users is set to Admin approved users are pre-authorized. See Set the connected app policies.

The connection fails with a username, password and security token in a newer org: Newer Salesforce orgs block the OAuth username-password flow by default. Turn on Allow OAuth Username-Password Flows, or use JWT authentication. See Allow the username-password flow.

The connection fails after a password change: Salesforce issues a new security token when the user’s password changes. Reset the token if needed and enter the new one in the portal. See Get your security token.

A JWT connection stops working after a year: The certificate created in the JWT guide is valid for 365 days. Generate a new certificate and upload it to the connected app. See How to Set Up Salesforce JWT Authentication for the Portal.

You can’t see Manage Consumer Details: Your Salesforce user needs permission to manage connected apps. Ask your Salesforce admin.

Business Central problems

The status shows Not connected: Re-enter the Client ID, Client Secret and Tenant ID and test again. Check that the app is added and enabled on the Microsoft Entra Applications page in Business Central. See Add the app in Business Central.

You lost the client secret value: Create a new client secret in Entra ID and enter the new value in the portal. See Create a client secret.

If the connection still fails

Ask the person who manages your CRM or Business Central to confirm the app, user and permission settings. If the details are correct and the portal still shows Not connected, contact CRMJetty support. See CRMJetty Support Policy and Response Times.

Did this solve it?No, contact support