Post, edit, boost and bookmark Mastodon statuses, read timelines, search, follow accounts and read notifications on your server.
Explore 30 workflow actions for Mastodon, including account permissions and operation limits.
16 read actions14 write actions
WORKFLOW ACTIONS
What you can configure.
Choose an action in the workflow builder, connect an account, and map its inputs. These actions are available in the catalog; your account access and a successful test determine whether they work for your setup.
Account statuses
Read
List an account's statuses, optionally only media, pinned or tagged, without replies or boosts.
Permissions and limits
Account permissions
A Mastodon access token with the read:statuses scope
Pagination: cursor. Check the result for additional pages; a single action may not return every record.
Bookmark status
Write
Bookmark a status.
Permissions and limits
Account permissions
A Mastodon access token with the write:bookmarks scope
A repeated request may repeat the external action. Review the previous result before retrying a write.
Boost status
Write
Boost (reblog) a status.
Permissions and limits
Account permissions
A Mastodon access token with the write:statuses scope
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete status
Write
Delete one of your statuses.
Permissions and limits
Account permissions
A Mastodon access token with the write:statuses scope
A repeated request may repeat the external action. Review the previous result before retrying a write.
Dismiss notification
Write
Dismiss one notification.
Permissions and limits
Account permissions
A Mastodon access token with the write:notifications scope
A repeated request may repeat the external action. Review the previous result before retrying a write.
Edit status
Write
Change a status's text, warning, media, poll or language.
Permissions and limits
Account permissions
A Mastodon access token with the write:statuses scope
A repeated request may repeat the external action. Review the previous result before retrying a write.
Favourite status
Write
Favourite a status.
Permissions and limits
Account permissions
A Mastodon access token with the write:favourites scope
A repeated request may repeat the external action. Review the previous result before retrying a write.
Follow account
Write
Follow an account, optionally with boosts, post notifications or chosen languages.
Permissions and limits
Account permissions
A Mastodon access token with the write:follows scope
A repeated request may repeat the external action. Review the previous result before retrying a write.
Get account
Read
Read an account.
Permissions and limits
Account permissions
A Mastodon access token with the read scope
Get my account
Read
Read the token's own account.
Permissions and limits
Account permissions
A Mastodon access token with the profile scope
Get notification
Read
Read a notification.
Permissions and limits
Account permissions
A Mastodon access token with the read:notifications scope
Get relationships
Read
Read whether you follow, block or mute accounts.
Permissions and limits
Account permissions
A Mastodon access token with the read:follows scope
Get server information
Read
Read the server's name, version, rules summary and limits.
Permissions and limits
Account permissions
A Mastodon access token with the read scope
Get status
Read
Read a status.
Permissions and limits
Account permissions
A Mastodon access token with the read scope
Get status context
Read
Read a status's ancestors and replies.
Permissions and limits
Account permissions
A Mastodon access token with the read scope
Hashtag timeline
Read
Read statuses with a hashtag, with optional extra tag rules.
Permissions and limits
Account permissions
A Mastodon access token with the read:statuses scope
Pagination: cursor. Check the result for additional pages; a single action may not return every record.
Home timeline
Read
Read your home timeline.
Permissions and limits
Account permissions
A Mastodon access token with the read:statuses scope
Pagination: cursor. Check the result for additional pages; a single action may not return every record.
List notifications
Read
List notifications, optionally by type or from one account.
Permissions and limits
Account permissions
A Mastodon access token with the read:notifications scope
Pagination: cursor. Check the result for additional pages; a single action may not return every record.
List timeline
Read
Read the timeline of one of your lists.
Permissions and limits
Account permissions
A Mastodon access token with the read:lists scope
Pagination: cursor. Check the result for additional pages; a single action may not return every record.
Look up account
Read
Find an account by username or user@server address.
Permissions and limits
Account permissions
A Mastodon access token with the read scope
Pin status
Write
Pin one of your statuses to your profile.
Permissions and limits
Account permissions
A Mastodon access token with the write:accounts scope
A repeated request may repeat the external action. Review the previous result before retrying a write.
Post status
Write
Post a status, a reply or a poll, now or scheduled.
Permissions and limits
Account permissions
A Mastodon access token with the write:statuses scope
A repeated request may repeat the external action. Review the previous result before retrying a write.
Public timeline
Read
Read the public timeline, optionally only local, remote or with media.
Permissions and limits
Account permissions
A Mastodon access token with the read:statuses scope
Pagination: cursor. Check the result for additional pages; a single action may not return every record.
Remove bookmark
Write
Remove a bookmark.
Permissions and limits
Account permissions
A Mastodon access token with the write:bookmarks scope
A repeated request may repeat the external action. Review the previous result before retrying a write.
Search
Read
Search accounts, hashtags and statuses.
Permissions and limits
Account permissions
A Mastodon access token with the read:search scope
Search accounts
Read
Search accounts by name or address.
Permissions and limits
Account permissions
A Mastodon access token with the read:accounts scope
Undo boost
Write
Undo a boost.
Permissions and limits
Account permissions
A Mastodon access token with the write:statuses scope
A repeated request may repeat the external action. Review the previous result before retrying a write.
Unfavourite status
Write
Remove a favourite.
Permissions and limits
Account permissions
A Mastodon access token with the write:favourites scope
A repeated request may repeat the external action. Review the previous result before retrying a write.
Unfollow account
Write
Unfollow an account.
Permissions and limits
Account permissions
A Mastodon access token with the write:follows scope
A repeated request may repeat the external action. Review the previous result before retrying a write.
Unpin status
Write
Unpin a status from your profile.
Permissions and limits
Account permissions
A Mastodon access token with the write:accounts scope
A repeated request may repeat the external action. Review the previous result before retrying a write.
SETUP
Start with a controlled test.
01Connect the intended account
Use the account and permissions required for your process. Review the connection check before configuring a workflow action.
02Review inputs and access
Select a listed operation and map its required inputs. Use test records and add a human approval before writes that need review.
03Confirm the result
Inspect step outputs and confirm the result in Mastodon. A saved workflow is not a completed provider action.