| The Account related list of orders doesn’t contain any records | The publisher user doesn’t have Read access to the Order__c object. The Account Customer Email values don’t match any Order Customer Email values. | Confirm that the publisher Run As user (for client credentials auth) or the authenticated user (for browser flow auth) has read access to the Order__c object. In the subscriber org, confirm that the Account’s Customer Email exactly matches an order’s email. |
| invalid_client_id | Consumer key mismatch or the wrong OAuth flow is enabled in the publisher external client app. | Re-copy the Consumer Key and Consumer Secret into the identity provider. Confirm that the correct auth flow is enabled in the external client app: for client credentials, select Enable Client Credentials Flow; for browser flow, select Enable Authorization Code and Credentials Flow. |
| Internal server error on Validate and Sync | Missing External Credential Principal Access permission set. | Create the permission set and assign it to your user before running Validate and Sync. |
| Unsupported Media Type error or redirected to login.salesforce.com/services/data | The named credential URL points to login.salesforce.com. | Update the named credential URL to the publisher org’s My Domain URL. For example: https://<domain>.my.salesforce.com |
| Client credentials authentication fails with token endpoint error | The identity provider URL points to login.salesforce.com. | The client credentials authentication flow doesn’t allow the global login URL. Set the external credential’s Identity Provider URL to https://<domain>.my.salesforce.com/services/oauth2/token |
| Authentication fails with a “missing required code challenge” PKCE error. | The external client app requires PKCE (Proof Key for Code Exchange), but the XIDP or auth provider isn’t sending a code challenge. | In the subscriber org, open the XIDP or auth provider, select Use Proof Key for Code Exchange (PKCE) Extension, and save. Then try authenticating again. |
| The browser flow authentication popup doesn’t complete. | Browser Flow is enabled on the external client app but the principal wasn’t authenticated. | Complete the browser authentication step. See Step 5: Authenticate Via a Browser. |
| Validate and Sync fails with “Internal server error.” | The user doesn’t have access to the external credential principal. This often happens when the permission set exists but the principal was never added to it. | In Setup, go to Permission Sets, open your permission set and select External Credential Principal Access. Then confirm that the principal (for example, ClientCredsPrincipal) is listed under Enabled. If the page is empty, click Edit and enable it. Click Manage Assignments and confirm your user is assigned to the permission set. Log out and back in, then retry Validate and Sync. |
| Unable to fetch the OAuth token. Error: invalid_request. Error description: scope parameter not supported. The attempted URL shown is login.salesforce.com. | The external credential’s identity provider URL is set to the global login URL. The token request must go to the publisher org’s My Domain. | Edit the external credential and set the Identity Provider URL to https://<publisher-my-domain>/services/oauth2/token. Save, and then retry Validate and Sync. |
| Unable to fetch the OAuth token. Error: oauth_flow_disabled. Error description: The external client app or the OAuth plugin is disabled. | The typical cause is a credential mismatch. The client_id or client_secret on the principal doesn’t match an enabled external client app in the publisher org. | In the publisher org, open the external client app and copy the Consumer Key and Consumer Secret. Then, in the subscriber org, open the principal and re-enter both as authentication parameters (client_id and client_secret). Save, then retry Validate and Sync. |