Actions48
- Account Actions
- Authentication Actions
- Blocks Actions
- Bookmarks Actions
- Favourites Actions
- Featured Tags Actions
- Follow Requests Actions
- Media Actions
- Mutes Actions
- Notifications Actions
- Polls Actions
- Status Actions
- Timeline Actions
Overview
This node enables interaction with the Mastodon API, a decentralized social networking platform. It supports a wide range of Mastodon features such as posting statuses, managing accounts, timelines, media uploads, polls, bookmarks, favourites, mutes, blocks, filters, follow requests, notifications, and more.
Common scenarios where this node is beneficial include automating social media posts, managing user interactions, retrieving timelines or notifications, moderating content, and integrating Mastodon data into workflows.
For example, you could use this node to automatically post updates to your Mastodon account when new content is published on your website, or to monitor and respond to notifications from your Mastodon instance.
Properties
| Name | Meaning |
|---|---|
| Mastodon URL | URL of the Mastodon instance to connect to. Example: https://mastodon.social |
Output
The node outputs JSON data representing the response from the Mastodon API for the selected resource and operation. The structure of the JSON depends on the specific API endpoint called. For example, it may contain status objects, account details, timeline entries, media metadata, poll results, etc.
If multiple items are returned (e.g., a list of statuses), each item is output as a separate JSON object in the output array.
The node does not explicitly handle binary data output.
Dependencies
- Requires an API authentication token credential configured in n8n to authenticate with the Mastodon instance.
- The Mastodon instance URL must be provided as input.
- No other external dependencies are required beyond standard HTTP access to the Mastodon API.
Troubleshooting
- Unknown Resource or Operation: If you select a resource or operation that is not implemented, the node will throw an error indicating the unsupported combination. Ensure you choose valid options supported by the node.
- Authentication Errors: If the API credentials are missing or invalid, API calls will fail. Verify that the API key or OAuth token is correctly configured.
- Instance URL Issues: Providing an incorrect or unreachable Mastodon instance URL will cause connection failures. Confirm the URL is correct and accessible.
- API Rate Limits: Mastodon instances may enforce rate limits. If you encounter errors related to too many requests, consider adding delays or reducing request frequency.
- Continue On Fail: If enabled, the node will continue processing subsequent items even if one fails, outputting error messages in the JSON field.