Mastodon

Mastodon is an open-source, federated microblogging network — posts, boosts, favourites, follows, hashtags and notifications.

Authentication

• Access token

Actions

Generic API request. Call any Mastodon API endpoint on this connection, for the case where no shipped action covers it yet — media uploads, bookmarks, lists, filters, scheduled posts, polls and votes, conversations, instance metadata, the moderation endpoints. The connection supplies the instance host, the authentication and the egress…

• Boost a statusBoost (reblog) a post as the connected account, putting it in front of that account's followers.
• Delete a statusDestructiveWithdraw one of the connected account's own posts.
• Favourite a statusFavourite a post as the connected account — the fediverse's like.
• Follow accountFollow an account as the connected account, so its posts reach mastodon:listhometimeline.
• Get a statusRead one post in full by its id — its text, author, counts, attachments and whether the connected account has already favourited or boosted it.
• Get accountRead one account's public profile by its instance-local id — display name, bio, follower counts and whether it requires follow approval.
• Get account (admin)Read one account as a moderator sees it, by its instance-local id — its email and whether it is confirmed, approved, disabled, silenced or suspended, its domain (absent for a local account) and its public profile under account.
• Get connected accountRead the account this connection authenticates as, plus its posting defaults.
• List account statusesRead one account's posts, newest first — the API behind a profile page.
• List hashtag timelineRead the posts carrying a hashtag, newest first — the fediverse's closest thing to a topic feed.
• List home timelineRead the home timeline of the connected account — posts by the accounts it follows, newest first.
• List notificationsRead what has happened to the connected account — mentions, favourites, boosts, follows and poll results, newest first.
• List public timelineRead the instance's public timeline — every public post the instance can see, newest first.
• Look up account by handleTurn a fediverse handle such as [email protected] into the numeric account id every account-scoped action here takes.
• Post a statusPublish a post to the fediverse as the connected Mastodon account — a plain post, a reply in a thread, a post carrying already-uploaded media, or a poll.
• SearchSearch this instance for accounts, hashtags and posts in one call.

Triggers

• Direct messages to the accountAnswers as an agent on Mastodon: when someone sends the connected account a direct message, the agent replies to them in that thread, visible only to the two of them.

Product names, logos and brands are the property of their respective owners and are used here for identification only. Their use does not imply endorsement by, or affiliation with, those owners.