{"templateId":"markdown","versions":[{"version":"1.0","label":"v1.0","link":"/docs/references/1.0/rest-api/errors/error-codes","default":false,"active":false,"folderId":"a015c489"},{"version":"1.1","label":"v1.1","link":"/docs/references/1.1/rest-api/errors/error-codes","default":false,"active":false,"folderId":"a015c489"},{"version":"1.2","label":"v1.2","link":"/docs/references/1.2/rest-api/errors/error-codes","default":false,"active":false,"folderId":"a015c489"},{"version":"1.3","label":"v1.3","link":"/docs/references/1.3/rest-api/errors/error-codes","default":false,"active":false,"folderId":"a015c489"},{"version":"1.4","label":"v1.4","link":"/docs/references/1.4/rest-api/errors/error-codes","default":false,"active":false,"folderId":"a015c489"},{"version":"2.0","label":"v2.0","link":"/docs/references/2.0/rest-api/errors/error-codes","default":false,"active":false,"folderId":"a015c489"},{"version":"2.1","label":"v2.1","link":"/docs/references/2.1/rest-api/errors/error-codes","default":false,"active":false,"folderId":"a015c489"},{"version":"2.2","label":"v2.2","link":"/docs/references/2.2/rest-api/errors/error-codes","default":false,"active":false,"folderId":"a015c489"},{"version":"2.3","label":"v2.3","link":"/docs/references/2.3/rest-api/errors/error-codes","default":false,"active":false,"folderId":"a015c489"},{"version":"2.4","label":"v2.4","link":"/docs/references/2.4/rest-api/errors/error-codes","default":false,"active":false,"folderId":"a015c489"},{"version":"2.5","label":"v2.5","link":"/docs/references/2.5/rest-api/errors/error-codes","default":false,"active":false,"folderId":"a015c489"},{"version":"2.6","label":"v2.6","link":"/docs/references/2.6/rest-api/errors/error-codes","default":false,"active":false,"folderId":"a015c489"},{"version":"2.7","label":"v2.7","link":"/docs/references/2.7/rest-api/errors/error-codes","default":false,"active":false,"folderId":"a015c489"},{"version":"2.8","label":"v2.8","link":"/docs/references/2.8/rest-api/errors/error-codes","default":false,"active":false,"folderId":"a015c489"},{"version":"2.9","label":"v2.9","link":"/docs/references/2.9/rest-api/errors/error-codes","default":false,"active":false,"folderId":"a015c489"},{"version":"2.10","label":"v2.10","link":"/docs/references/2.10/rest-api/errors/error-codes","default":false,"active":false,"folderId":"a015c489"},{"version":"2.11","label":"v2.11","link":"/docs/references/2.11/rest-api/errors/error-codes","default":false,"active":false,"folderId":"a015c489"},{"version":"2.12","label":"v2.12","link":"/docs/references/2.12/rest-api/errors/error-codes","default":false,"active":false,"folderId":"a015c489"},{"version":"2.13","label":"v2.13","link":"/docs/references/2.13/rest-api/errors/error-codes","default":false,"active":false,"folderId":"a015c489"},{"version":"2.14","label":"v2.14","link":"/docs/references/2.14/rest-api/errors/error-codes","default":false,"active":false,"folderId":"a015c489"},{"version":"2.15","label":"v2.15","link":"/docs/references/2.15/rest-api/errors/error-codes","default":false,"active":false,"folderId":"a015c489"},{"version":"2.16","label":"v2.16","link":"/docs/references/2.16/rest-api/errors/error-codes","default":false,"active":false,"folderId":"a015c489"},{"version":"2.17","label":"v2.17","link":"/docs/references/2.17/rest-api/errors/error-codes","default":false,"active":true,"folderId":"a015c489"},{"version":"2.18","label":"v2.18","link":"/docs/references/rest-api/errors/error-codes","default":true,"active":false,"folderId":"a015c489"},{"version":"Preview","label":"Preview","link":"/docs/references/preview/rest-api/errors/error-codes","default":false,"active":false,"folderId":"a015c489"}],"sharedDataIds":{"sidebar":"sidebar-docs/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Error Codes","projectTitle":"Intercom and Fin Developer Platform","description":"Faster resolutions, higher CSAT, and lighter support volumes with the only platform to combine the power of automation and human customer support.","siteUrl":"https://developers.intercom.com","image":"/assets/og-image.9c9ef3a6cedbceee0e1d52fae2ffcce97f5a189639cf24e473331da9ad02c5f8.b1bff462.png"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"error-codes","__idx":0},"children":["Error Codes"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The API may send the following error codes. Other codes may be added in the future."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["server_error"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Generic server error"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["client_error"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Generic client error"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["bad_request"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The request could not be processed"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["type_mismatch"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The JSON value type is incorrect for the field"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["parameter_not_found"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["A required parameter was not supplied"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["parameter_missing"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["A required parameter was not supplied"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["missing_parameter"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["A required parameter was not supplied"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["parameter_invalid"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["A parameter's value is invalid"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["data_invalid"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The data in the request is invalid"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["unprocessable_entity"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The data was well-formed but invalid"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["not_found"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The resource does not exist"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["action_forbidden"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The action is not authorized"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["forbidden"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The request is not allowed"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["conflict"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["There is existing data that clashes with the request data"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["resource_conflict"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The resource already exists"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["api_plan_restricted"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The API or feature is not available on this App's Plan or workspace"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["rate_limit_exceeded"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The rate limit for the App has been exceeded"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["too_many_requests"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The server is receiving too many requests for this resource; retry later"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["request_timeout"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The server timed out while processing the request"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["service_unavailable"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The service is temporarily unavailable; retry later"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["unsupported"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The operation is not supported"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["unauthorized"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The request could not be authenticated, for example because the access token is invalid or has been revoked"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["token_not_found"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The token or API Key does not exist"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["token_unauthorized"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The token or API Key is not allowed to access the resource"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["token_suspended"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The workspace or app that the token belongs to has been suspended"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["missing_authorization"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["No authorization data was found on the request"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["media_type_not_acceptable"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Accept"]}," header is missing or is not a media type the endpoint returns"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["intercom_version_invalid"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Intercom-Version"]}," header is not a valid API version, or the requested resource or parameter is not available in that version"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["not_restorable"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["This user was blocked and cannot be recreated"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["team_not_found"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The team does not exist"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["admin_not_found"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The admin does not exist"]}]}]}]}]}]},"headings":[{"value":"Error Codes","id":"error-codes","depth":1}],"frontmatter":{"seo":{"title":"Error Codes"}},"lastModified":"2026-10-21T15:54:12.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/references/2.17/rest-api/errors/error-codes","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}