Skip to main content

Connecting your Mastodon account to Ocoya

Connect a Mastodon account hosted on any server so you can schedule posts from Ocoya

Written by Joe

Mastodon is a decentralised social network made up of independently run servers. Ocoya can publish to an account on any Mastodon server, so the first step is telling Ocoya which server your account lives on.

Before you start

  • Know your Mastodon server address — the part after the second @ in your full handle. For example, if your handle ends in mastodon.social, then mastodon.social is your server.

  • Log in to the correct Mastodon account in your browser first. The authorisation step connects whichever account is currently signed in on that server.

Connecting a Mastodon account

1. In Ocoya, go to Connections → Channels in the left-hand menu, then click Browse all to open the list of available platforms.

Ocoya's Integrate screen listing all available platforms to connect

2. Find the Mastodon card and click Connect. You can also type "mastodon" into the search box at the top to filter the list.

The Mastodon card on Ocoya's Integrate screen, alongside Threads and Discord

3. Enter your server address in the Mastodon server field. Ocoya offers shortcuts for common servers — mastodon.social, mas.to, mastodon.world, mastodon.online and techhub.social — so you can click one instead of typing it. Then click Continue to Mastodon.

The Connect Mastodon dialog with a server entered and the Continue to Mastodon button enabled

4. You'll be taken to your Mastodon server, which shows which account you're signed in as and exactly what Ocoya is requesting: Accounts (read-only), Posts (write-only), Media attachments (write-only) and Follows (write-only). Click Authorise.

Mastodon's authorisation screen listing the permissions Ocoya requests, with Authorise and Deny buttons

5. You'll be returned to Ocoya, and your Mastodon account appears under Channels, ready to select in the post composer.

The Channels screen in Ocoya showing a connected Mastodon account alongside Facebook and X

Things worth knowing

  • Enter the server address only — for example mastodon.social, not https://mastodon.social and not your full handle.

  • Self-hosted and smaller community servers work too. Any server running standard Mastodon can be used, not just the ones listed as shortcuts.

  • Each Mastodon account is connected separately. To publish to several accounts, repeat these steps for each one.

Reconnecting a Mastodon account

If your Mastodon connection stops working — for example after revoking access on the Mastodon side — reconnect it:

  1. Go to Connections → Channels and click Manage next to the Mastodon channel.

  2. Click Disconnect.

  3. Connect the account again using the steps above.

The Manage connection screen in Ocoya, showing channel details and the Disconnect button

Troubleshooting Mastodon connection issues

Server not found

Check that:

  • You entered the server address without https:// and without a trailing slash.

  • The address is spelled correctly.

  • The server is online and reachable in your browser.

You were connected to the wrong account

The authorisation screen shows which account you're signed in as, just above the permissions list. If it's the wrong one, use the log-out icon there, sign in as the correct account, then disconnect and reconnect in Ocoya.

Authorisation failed or the page returned an error

Some servers restrict third-party applications. If approval fails, check with your server's administrator that API access is permitted, then try again.

Need help?

If you're having trouble connecting Mastodon, contact the Ocoya support team and include:

  • Your Mastodon server address

  • Any error messages you received

  • Screenshots, if available

This information will help us investigate the issue more quickly.

Related Articles
Did this answer your question?