Connect

Mastodon

Mastodon is federated, so you first tell Modiva which instance your account lives on (for example mastodon.social). Modiva then runs the standard OAuth flow against that instance.

Before you start

A Mastodon account.
The domain of your home instance (e.g. mastodon.social, fosstodon.org).

Step-by-step setup

1
Sign in to Modiva
Log in at modiva.ai and open the Dashboard. You need a Modiva account before you can connect any platform — creating one takes a minute and no credit card is required for the free tier.
The Modiva dashboard — your home for connections, posts and analytics.
2
Open Connections → New connection
In the left sidebar choose Connections, then click New connection. You'll see the full catalogue of platforms grouped by category (Social and Ads).
The connection picker. Use the search box or category filter to find your platform.
3
Enter your instance domain
Click the Mastodon card and type your home instance domain. Modiva registers itself with that instance and redirects you there to authorize.
Mastodon is federated — tell Modiva which instance hosts your account.
4
Authorize on your instance
Sign in on your Mastodon instance and approve the requested permissions. You're redirected back to Modiva with a Connected status.
Approve Modiva on your own Mastodon instance.

Permissions Modiva requests

When you connect Mastodon, Modiva asks only for the access it needs to run the tools you use. You can revoke it any time from Mastodon or by disconnecting in Modiva.

Read your profile and timelines
Publish and reply to posts (toots) on your behalf

Troubleshooting & FAQ

Where is my Mastodon password stored?

Nowhere. You sign in on the provider's own site and Modiva only receives a scoped access token, which is encrypted at rest with AES-256-GCM. Modiva never sees your password.

My connection says Expired or Error — what do I do?

Open Connections, find the platform and click Reconnect (or Refresh token). Providers periodically expire tokens or revoke them when you change your password; reconnecting re-runs the consent screen and restores access.

How do I disconnect?

Open Connections, click the Mastodon row and choose Disconnect. Modiva deletes the stored token immediately. You can also revoke Modiva from inside Mastodon's own app settings.