Handle Errors in REST API

Validation

Description Resolution HTTP Error Custom
Generic Exception Verify that you included the proper endpoint and resource. 400 10000
Invalid Data Type Confirm that the parameters of your request include the required data types. 400 10001
Missing Required Field Confirm that the request includes all required fields. 400 10002
Incorrect Format Verify that the request is formatted correctly. 400 10003
Invalid Message Format Make sure that the request body has balanced braces and brackets. 400 10004
Invalid Value Make sure that all values in the request are of the correct data types. 400 10005
Aggregate Error Check additionalErrors for detailed error messages. 400 10006
Unsupported Media Type Make sure that all media formats in the request are valid and allowed. 415

Authorization

Description Resolution HTTP Error Custom
General Exception Ensure you provide the correct resource. 403 20000
Business Rule Not Set Review the associated permissions and ensure you provide the proper configuration. 403 20001
Insufficient Privileges Your account lacks the privileges necessary to perform the request. 403 20002

Authentication

Description Resolution HTTP Error Custom
Not Authorized The access token in the request is missing, invalid, or expired. 401 0
Authorization token invalid on URL or request body Verify that the request header contains a valid access token. 401 40004
General Ensure the request specifies the correct resource. 403 40000
Not Authenticated Verify that the request header contains a valid access token. 403 40001
Authorization token invalid on this endpoint Use the stack-level endpoint that matches your token. 403 40002
Authorization token invalid on URL Verify that the request header contains a valid access token. 403 40003
Internal Server Error See the response returned by the HTTP routing assertion. 500
Service Not Found The resource you’re trying to access doesn’t exist. Verify that the request specifies the correct resource. 596

Runtime

Description Resolution HTTP Error Custom
Generic Verify that your request specifies the correct resource. 400 30000
Invalid Operation Your request uses an invalid HTTP operation for the resource. Modify the request to use a valid operation. 400 30001
Invalid State Transition This operation requests an invalid state transition for the resource. Ensure you request a valid state transition. 409 30002
Object Not Found Your request can’t find any available data. Ensure you properly created your request. 404 30003
Execution Timeout Expired Retry the API call using Exponential Backoff. 408 —
Object Already Exists An existing object has the same ID, key, or name as the object specified in the request. Provide a unique value and try again. 409 30004
Too many requests Retry the API call after number of seconds specified in “Retry-After” header field. 429 50100
Too many requests Your API requests are temporarily blocked due to too many concurrent requests. Contact Salesforce Customer Support for more information about the issue. 429 50200
Service Unavailable Retry the API call after number of seconds specified in “Retry-After” header field. 503 50300