{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-installing-intercom/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Error Codes","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","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"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 Intercom React Native wrapper surfaces errors from the underlying native iOS and Android SDKs as Promise rejections. You can catch these errors using standard JavaScript error handling patterns."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"handling-errors","__idx":1},"children":["Handling errors"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All Intercom methods return a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Promise"]},". When a call fails, the Promise is rejected with an error object containing a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["code"]}," (string) and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["message"]},"."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"javascript","header":{"controls":{"copy":{}}},"source":"try {\n  await Intercom.loginUserWithUserAttributes({ email: 'bob@example.com' });\n} catch (error) {\n  console.log('Error code:', error.code);   // e.g. '102'\n  console.log('Error message:', error.message);\n}\n","lang":"javascript"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Or using Promise chains:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"javascript","header":{"controls":{"copy":{}}},"source":"Intercom.loginUserWithUserAttributes({ email: 'bob@example.com' })\n  .catch((error) => {\n    console.log('Error code:', error.code);\n    console.log('Error message:', error.message);\n  });\n","lang":"javascript"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"list-of-error-codes","__idx":2},"children":["List of error codes"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The React Native bridge defines its own error codes that are returned as strings in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["error.code"]},". These identify which operation failed:"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"user-and-identity-error-codes","__idx":3},"children":["User and identity error codes"]},{"$$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":"Error Code"},"children":["Error Code"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Operation"},"children":["Operation"]},{"$$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":["101"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["loginUnidentifiedUser"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["An error occurred while logging in an unidentified user."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["102"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["loginUserWithUserAttributes"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["An error occurred while logging in an identified user."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["103"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["setUserHash"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["An error occurred while setting the user hash for identity verification."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["104"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["updateUser"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["An error occurred while updating user attributes."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["105"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["logEvent"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["An error occurred while logging an event."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["106"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["logout"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["An error occurred while logging out the user. Android only."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["107"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["setLogLevel / getUnreadConversationCount"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["An error occurred while setting log level (Android) or fetching unread count (iOS)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["109"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["setUserJwt"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["An error occurred while setting a user JWT."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["110"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["setAuthTokens"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["An error occurred while setting authentication tokens."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["111"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["initialize"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["An error occurred while initializing the Intercom SDK."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"display-error-codes","__idx":4},"children":["Display error codes"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Android only"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The display error codes below are only returned on Android. On iOS, these operations always resolve successfully without error codes."]}]},{"$$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":"Error Code"},"children":["Error Code"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Operation"},"children":["Operation"]},{"$$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":["201"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["present"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["An error occurred while presenting the Messenger."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["202"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["presentMessageComposer"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["An error occurred while presenting the message composer."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["203"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["presentContent"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["An error occurred while presenting content (article, survey, carousel, etc.)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["205"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["setInAppMessageVisibility"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["An error occurred while setting in-app message visibility."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["206"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["hideIntercom"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["An error occurred while hiding the Intercom UI."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["208"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["setLauncherVisibility"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["An error occurred while setting launcher visibility."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["209"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["setBottomPadding"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["An error occurred while setting the bottom padding."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["210"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["setThemeMode"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["An error occurred while setting the theme mode."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"push-notification-error-codes","__idx":5},"children":["Push notification error codes"]},{"$$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":"Error Code"},"children":["Error Code"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Operation"},"children":["Operation"]},{"$$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":["302"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["sendTokenToIntercom"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["An error occurred while registering a device token for push notifications."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"help-center-data-api-error-codes","__idx":6},"children":["Help Center data API error codes"]},{"$$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":"Error Code"},"children":["Error Code"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Operation"},"children":["Operation"]},{"$$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":["901"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["fetchHelpCenterCollections"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["An error occurred while fetching Help Center collections."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["902"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["fetchHelpCenterCollection"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["An error occurred while fetching the contents of a Help Center collection."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["903"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["searchHelpCenter"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["An error occurred while searching the Help Center."]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Underlying native errors"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["error.code"]}," values above identify which React Native bridge operation failed. Note that ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["error.code"]}," is a string (e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["'102'"]},"), not a number. The underlying cause comes from the native iOS or Android SDK. For detailed descriptions of native-level error codes, see the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developers.intercom.com/installing-intercom/ios/error-codes/"},"children":["iOS error codes"]}," and ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developers.intercom.com/installing-intercom/android/error-codes/"},"children":["Android error codes"]}," reference pages."]}]}]},"headings":[{"value":"Error Codes","id":"error-codes","depth":1},{"value":"Handling errors","id":"handling-errors","depth":2},{"value":"List of error codes","id":"list-of-error-codes","depth":2},{"value":"User and identity error codes","id":"user-and-identity-error-codes","depth":3},{"value":"Display error codes","id":"display-error-codes","depth":3},{"value":"Push notification error codes","id":"push-notification-error-codes","depth":3},{"value":"Help Center data API error codes","id":"help-center-data-api-error-codes","depth":3}],"frontmatter":{"seo":{"title":"Error Codes"}},"lastModified":"2026-04-21T12:57:13.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/installing-intercom/react-native/error-codes","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}