FANDOM


API Options Navigation

The API page presents user credentials (the User ID and the API Token), and for the Android App, displays a QR Code. These user credentials are often used to indicate and verify details in Habitica applications and extensions. The page can be accessed on the web from the Settings option under the User Icon menu. Alternatively, on the apps, it can be accessed by tapping on the settings icon at the top right of the menu and then the API option.


User ID (UID) Edit

The User ID (UID) or Universally Unique IDentifier (UUID) is a complex hexadecimal number that Habitica automatically generates when a player joins, similar to a Username. However, unlike the Username, this can not be changed once assigned to the player.

User-ID

You'll need it to:

To find your User ID:

  • For the website: User Icon > Settings > API
  • For iOS/Android App: Menu > Settings > API > User ID (tap on it to copy it to your clipboard).
Userid

The profile page of WikiFAQ bot.

To find someone else's User ID on the website, click on that person's name in Tavern Chat or any other Habitica chat room. A new URL will appear in your browser's address bar, in the format https://habitica.com/profile/UserID (for example, the URL for WikiFAQ bot's profile page is https://habitica.com/profile/29bfa638-cb88-40e8-a0d0-48f455e7b2bd). The UserID portion of the URL will be that user's User ID. If you are already in a party with them, you can view their profile by clicking their name in the Members box on your party page. Note that if you refresh your browser while on this pop-up or open this URL in a new tab, you will leave the chat room and see a full-screened version of that user's profile. This feature is currently unavailable on the mobile apps.

API Token Edit

The API token is a unique security code generated along with your User ID. It is similar to a password so it is essential that you keep this token private and never share this token with any untrustworthy applications or people! If you have accidentally shared your API token in a public space or with an untrusted source you can ask in the Report a Bug Guild or email admin@habitica.com to change your API token.

To find your API Token,

  • For the website: User Icon > Settings > API
  • For iOS/Android App: Menu > API > API Token (tap on it to copy it to your clipboard).

Third Party AppsEdit

On the website, the Third Party Apps section of the API page includes links to third-party applications that are or can be integrated with Habitica, along with explanations of each application's purpose.

API Third Party Apps

The third-party applications listed on the API page.

WebhooksEdit

This section allows users to customize Webhooks that will activate scripts on other websites when certain actions (for example, task completion) occur in a user's Habitica account. Because incorrect URLs can cause errors or slow Habitica, Habiticans should exercise caution in using this feature. For more information, see the Webhooks page on this wiki.

QR Code Edit

WikiFAQ Bot QR Code

QR Code for WikiFAQ Bot

The QR Code is a representation of your User ID in a graphical scannable format. The QR Code does not contain your API Token. Instead, it contains the following URL: https://habitica.com/qr-code/user/[User ID].

For example, the QR Code for WikiFAQ bot (User ID: 29bfa638-cb88-40e8-a0d0-48f455e7b2bd) is: https://habitica.com/qr-code/user/29bfa638-cb88-40e8-a0d0-48f455e7b2bd.

The QR Code can currently be used by the iOS app to invite party members.

At this time, the only way to generate a QR Code within the game is to use the Android app, by selecting Menu > Settings > API > User ID. It is also possible to use external websites or apps to generate a QR Code if access to the Android app is unavailable.

Community content is available under CC-BY-SA unless otherwise noted.