Salesforce Error Troubleshooting Guide

Find solutions to common Salesforce errors. Learn how to identify, troubleshoot, and fix errors quickly with Clientell AI.

Field Custom Validation Exception

FIELD_CUSTOM_VALIDATION_EXCEPTION

This error occurs when a custom validation rule prevents a record from being saved. The validation rule evaluates to true, blocking the operation.

Validation Errors

Insufficient Access on Cross-Reference Entity

INSUFFICIENT_ACCESS_ON_CROSS_REFERENCE_ENTITY

This error occurs when a user tries to create or update a record that references another record they don't have access to, typically due to sharing rules or field-level security.

Access Errors

Duplicate Value

DUPLICATE_VALUE

This error occurs when trying to insert or update a record with a value that violates a unique constraint, such as a duplicate email, external ID, or unique field.

Data Errors

Required Field Missing

REQUIRED_FIELD_MISSING

This error occurs when attempting to save a record without populating a required field. The field may be required at the object level or by a validation rule.

Validation Errors

Cannot Insert/Update/Activate Entity

CANNOT_INSERT_UPDATE_ACTIVATE_ENTITY

This error typically occurs when trying to activate or modify a metadata component (like a workflow, flow, or validation rule) that has errors or dependencies.

System Errors

Invalid Field for Insert/Update

INVALID_FIELD_FOR_INSERT_UPDATE

This error occurs when trying to set a field that cannot be modified, such as a formula field, auto-number field, or system field that's read-only.

Validation Errors

Invalid Operation

INVALID_OPERATION

This generic error occurs when attempting an operation that's not allowed, such as deleting a record with dependencies or modifying a locked record.

System Errors

Malformed ID

MALFORMED_ID

This error occurs when an invalid Salesforce record ID is provided. IDs must be 15 or 18 characters and match the expected format for the object type.

Data Errors

String Too Long

STRING_TOO_LONG

This error occurs when trying to save a text value that exceeds the maximum length allowed for the field.

Validation Errors

Invalid Type

INVALID_TYPE

This error occurs when the wrong data type is provided for a field, such as trying to set a number field with text or a date field with an invalid format.

Validation Errors

Entity Is Deleted

ENTITY_IS_DELETED

This error occurs when trying to access or reference a record that has been deleted, typically in a lookup or master-detail relationship.

Data Errors

Self Reference From Trigger

SELF_REFERENCE_FROM_TRIGGER

This error occurs when a trigger tries to update the same record that triggered it, creating a recursive loop that Salesforce prevents.

System Errors

Query Exception

QUERY_EXCEPTION

This error occurs when a SOQL query is malformed, references non-existent fields, or violates query rules.

System Errors

Governor Limit Exceeded

GOVERNOR_LIMIT_EXCEEDED

This error occurs when a process exceeds Salesforce's governor limits, such as too many SOQL queries, DML operations, or CPU time.

System Errors

Invalid Login

INVALID_LOGIN

This error occurs when authentication fails, typically due to incorrect credentials, expired sessions, or security token issues.

Access Errors

Invalid Query Locator

INVALID_QUERY_LOCATOR

This error occurs when using queryMore() with an invalid or expired query locator, typically in pagination scenarios.

System Errors