Integrating Hellō Mastodon Builder

A Mastodon integrating new scaffolding

A Guide for Mastodon Server Admins

While testing the Hellō Mastodon Builder, a number of Mastodon server admins expressed interest in integrating it into their servers. Everyone with a Mastodon account can use Hellō Mastodon Builder by going to, entering their server name, and then logging in and authorizing access to their account.

You can remove the step of entering your server name for your users by adding a server query parameter with the domain of your server to the link. For example:

Hellō will know which Mastodon server to use and the user will not need to enter it in.  We will redirect the user back to your server with an authorization request to access their profile. (If the user already has a Hellō Wallet, they will be prompted to login first) This provides a more seamless user experience as your user will not need to enter your server domain.

When the user has completed updating their profile, Hellō Mastodon Builder will revoke the access that was granted to it. No need to remind your user’s to go to /oauth/authorized_applications to revoke access.

Below, you can see we have added the link for Hellō Mastodon Builder on in the Edit profile page by editing the Mastodon source:

Alternatively, you could toot a message with the link to your users, or put it in an announcement.

Hellō is on a mission to make digital identity reusable. We would love to hear any of your feedback or suggestions. You can find us on Mastodon at or leave a comment below.

2 responses

  1. Mark Gardner Avatar
    Mark Gardner

    It’s not clear whether users need to sign up for a Hellō Wallet if they don’t already have one. (I wouldn’t fault you if they did, but it’d be nice to spell it out.)

  2. Dick Hardt Avatar
    Dick Hardt

    Using the Hellō Wallet implicitly creates a wallet for users. We found explaining that they are creating a wallet gets in the way of accomplishing the task.

Leave a Reply