simple_salesforce.exceptions module

All exceptions for Simple Salesforce

exception simple_salesforce.exceptions.SalesforceAuthenticationFailed(code, auth_message)

Bases: SalesforceError

Thrown to indicate that authentication with Salesforce failed.

This exception is raised when authentication with Salesforce fails, typically during login or token validation. It maintains compatibility with the SalesforceError base class while providing a simplified constructor for authentication-specific error reporting.

Parameters:

• code (Union[str, int, None]) – Error code from Salesforce authentication response

• message – Descriptive error message from authentication failure

__init__(code, auth_message)

Initialize SalesforceAuthenticationFailed exception.

Parameters:

• code (Union[str, int, None]) – Error code from Salesforce (can be string, int, or None)

• auth_message (str) – Authentication failure message

Raises:

TypeError – If auth_message is not a string

message: str = 'Authentication failed. Response content: {content}'

exception simple_salesforce.exceptions.SalesforceBulkV2ExtractError

Bases: SalesforceOperationError

Error occurred during bulk 2.0 extract

exception simple_salesforce.exceptions.SalesforceBulkV2LoadError

Bases: SalesforceOperationError

Error occurred during bulk 2.0 load

exception simple_salesforce.exceptions.SalesforceError(url, status, resource_name, content)

Bases: Exception

Base Salesforce API exception

__init__(url, status, resource_name, content)

Initialize the SalesforceError exception

SalesforceError is the base class of exceptions in simple-salesforce

Parameters:

• url (str) – Salesforce URL that was called

• status (int) – Status code of the error response

• resource_name (str) – Name of the Salesforce resource being queried

• content (bytes) – content of the response

message: str = 'Unknown error occurred for {url}. Response content: {content}'

exception simple_salesforce.exceptions.SalesforceExpiredSession(url, status, resource_name, content)

Bases: SalesforceError

Error Code: 401 The session ID or OAuth token used has expired or is invalid. The response body contains the message and errorCode.

message: str = 'Expired session for {url}. Response content: {content}'

exception simple_salesforce.exceptions.SalesforceGeneralError(url, status, resource_name, content)

Bases: SalesforceError

A non-specific Salesforce error.

message: str = 'Error Code {status}. Response content: {content}'

exception simple_salesforce.exceptions.SalesforceMalformedRequest(url, status, resource_name, content)

Bases: SalesforceError

Error Code: 400 The request couldn’t be understood, usually because the JSON or XML body contains an error.

message: str = 'Malformed request {url}. Response content: {content}'

exception simple_salesforce.exceptions.SalesforceMoreThanOneRecord(url, status, resource_name, content)

Bases: SalesforceError

Error Code: 300 The value returned when an external ID exists in more than one record. The response body contains the list of matching records.

message: str = 'More than one record for {url}. Response content: {content}'

exception simple_salesforce.exceptions.SalesforceOperationError

Bases: Exception

Base error for Bulk API 2.0 operations

exception simple_salesforce.exceptions.SalesforceRefusedRequest(url, status, resource_name, content)

Bases: SalesforceError

Error Code: 403 The request has been refused. Verify that the logged-in user has appropriate permissions.

message: str = 'Request refused for {url}. Response content: {content}'

exception simple_salesforce.exceptions.SalesforceResourceNotFound(url, status, resource_name, content)

Bases: SalesforceError

Error Code: 404 The requested resource couldn’t be found. Check the URI for errors, and verify that there are no sharing issues.

message: str = 'Resource {name} Not Found. Response content: {content}'