Skip to content

Error Codes

The API may send the following error codes. Other codes may be added in the future.

FieldDescription
server_errorGeneric server error
client_errorGeneric client error
bad_requestThe request could not be processed
type_mismatchThe JSON value type is incorrect for the field
parameter_not_foundA required parameter was not supplied
parameter_missingA required parameter was not supplied
missing_parameterA required parameter was not supplied
parameter_invalidA parameter's value is invalid
data_invalidThe data in the request is invalid
unprocessable_entityThe data was well-formed but invalid
not_foundThe resource does not exist
action_forbiddenThe action is not authorized
forbiddenThe request is not allowed
conflictThere is existing data that clashes with the request data
resource_conflictThe resource already exists
api_plan_restrictedThe API or feature is not available on this App's Plan or workspace
rate_limit_exceededThe rate limit for the App has been exceeded
too_many_requestsThe server is receiving too many requests for this resource; retry later
request_timeoutThe server timed out while processing the request
service_unavailableThe service is temporarily unavailable; retry later
unsupportedThe operation is not supported
unauthorizedThe request could not be authenticated, for example because the access token is invalid or has been revoked
token_not_foundThe token or API Key does not exist
token_unauthorizedThe token or API Key is not allowed to access the resource
token_suspendedThe workspace or app that the token belongs to has been suspended
missing_authorizationNo authorization data was found on the request
media_type_not_acceptableThe Accept header is missing or is not a media type the endpoint returns
intercom_version_invalidThe Intercom-Version header is not a valid API version, or the requested resource or parameter is not available in that version
not_restorableThis user was blocked and cannot be recreated
team_not_foundThe team does not exist
admin_not_foundThe admin does not exist