If an export to Salesforce fails, Cognism displays the error returned by Salesforce.

This article explains the most common Salesforce export errors, what they mean, and how to resolve them.

If you're unsure why an export failed, first verify that:

The Salesforce integration is connected.
You are logged in to Salesforce.
Your Salesforce session has not expired.
You have permission to create or update Salesforce records.
Your Salesforce administrator has completed the required integration setup.

Authentication errors

Missing parameter: code

What it means

Cognism could not complete the Salesforce authentication process.

This error typically occurs when the Salesforce Connected App is not configured correctly or Salesforce blocks the OAuth authorisation request.

Common causes

The Cognism Chrome Connected App has not been installed or approved in Salesforce.
IP restrictions are enforced on the Connected App.
The Salesforce authorisation process was interrupted.
The Connected App policies were recently changed.

Resolution

In Salesforce, go to Setup > Connected Apps > Manage Connected Apps.
Verify that the Cognism Chrome Connected App is installed and approved.
Open Edit Policies for the Connected App.
Under IP Relaxation, select Relax IP restrictions.
Save the changes.
Disconnect the Salesforce integration in Cognism.
Reconnect Salesforce and complete the authorisation process again.

If your organisation requires IP allowlisting instead of relaxed IP restrictions, configure Cognism's static IP addresses before reconnecting the integration. For more information, see Use Static IP Restrictions with Salesforce.

Invalid Session ID/ Error 400

What it means

Your Salesforce authentication session has expired or is no longer valid.

Common causes

Your Salesforce session has expired.
Your password has changed.
The Salesforce integration was disconnected.
Your organisation switched between Sandbox and Production.

Resolution

Sign out of Salesforce.
Disconnect the Salesforce integration.
Reconnect Salesforce.
Retry the export.

Permission errors

API Disabled

What it means

Your Salesforce organisation does not have API access enabled.

Common causes

API access is disabled.
You are using an unsupported Salesforce edition.

Resolution

API access must be enabled before Cognism can communicate with Salesforce.

For Salesforce Professional Edition, contact Salesforce to enable API access.

View Setup and Configuration permission required

What it means

The Salesforce administrator performing the integration does not have all required permissions.

Resolution

Ensure the administrator has:

View Setup and Configuration
Marketing User
Read, Create and Edit access to Leads
Read, Create and Edit access to Contacts
Read, Create and Edit access to Accounts

If Data Import is enabled, additional permissions are also required.

See Configure the Salesforce Integration.

Insufficient access to object

What it means

The exporting Salesforce user does not have permission to access or modify one or more Salesforce records.

Common causes

Missing object permissions.
Missing field permissions.
Record sharing restrictions.
Access to related records is restricted.

Resolution

Ask your Salesforce Administrator to review:

Object permissions
Field-level security
Record ownership
Sharing rules

Campaign access error

What it means

The exporting user does not have permission to add records to the selected Salesforce Campaign.

Resolution

Verify that the exporting user has permission to:

View Campaigns
Add Campaign Members
Access the selected Campaign

Data validation errors

Duplicate Rules

What it means

Salesforce identified the record as a duplicate and blocked the export.

Resolution

Review your Salesforce Matching Rules and Duplicate Rules.

Cognism performs its own matching before exporting, but Salesforce always performs an additional duplicate check before creating or updating records.

See Configure Salesforce Duplicate and Matching Rules.

Bad value for restricted picklist field

What it means

The value exported by Cognism does not exist in the Salesforce picklist.

Resolution

Verify that:

The picklist contains the exported value.
The field mapping is correct.
The value has not been removed from Salesforce.

No such column

What it means

A mapped Salesforce field cannot be found.

Common causes

The field has been deleted.
The API name has changed.
The exporting user cannot access the field (no View permission for the specific field or it is not visible on page layout in Salesforce.

Resolution

Review your Salesforce Layout and Field permissions and update or remove the affected field mapping.

Invalid Country or State Code

What it means

Salesforce Country and State Picklists are enabled, but the exported values do not match the configured codes.

Resolution

Review your Salesforce Country and State configuration and update the mapped values if required.

You need to map Country Code and State Code from Salesforce and use Conditional mapping to align the values.

Converted Lead

What it means

The Lead has already been converted into a Contact.

Resolution

Export the record as a Contact instead of a Lead, or update the existing Contact record.

FIELD_CUSTOM_VALIDATION_EXCEPTION

What it means

A Salesforce Validation Rule prevented the record from being created or updated.

Resolution

Review the Validation Rule in Salesforce and ensure the exported record meets all required conditions before exporting again.

Other errors

403 Forbidden

What it means

Salesforce rejected the request for security reasons.

Common causes

IP restrictions.
Connected App restrictions.
Missing permissions.
Salesforce security policies.

Resolution

Review your Salesforce security settings and Connected App configuration.

If your organisation uses IP allowlisting, see Use Static IP Restrictions with Salesforce.

Generic export error

What it means

Salesforce returned an unexpected error that could not be categorised.

Resolution

Try the export again.

If the issue persists:

Confirm the Salesforce integration is connected.
Review your field mappings.
Verify your Salesforce permissions.
Contact Cognism Support with the complete error message and the record you attempted to export.

Still having problems?

If the issue cannot be resolved, provide the following information when contacting Cognism Support:

The complete Salesforce error message.
The email address of the exported contact.
The company name.
Whether you exported as a Lead or Contact.
Whether the issue affects one or multiple records.
A screenshot of the error, if available.

This information helps us investigate the issue more quickly.