Mastodon icon

Mastodon

Interact with Mastodon API

Overview

This node allows users to interact with the Mastodon API, specifically enabling operations on various Mastodon resources such as statuses, accounts, timelines, media, and more. For the Status - View Status operation, it retrieves detailed information about a specific status (post) from a Mastodon instance by its ID.

Common scenarios for this node include:

  • Fetching a particular Mastodon post's details for analysis or display.
  • Integrating Mastodon content into other workflows or applications.
  • Monitoring specific posts for updates or metadata extraction.

Practical example:

  • A social media monitoring workflow that fetches a Mastodon status by its ID to analyze engagement or content.
  • Archiving or backing up specific Mastodon posts by retrieving their full data.

Properties

Name Meaning
Mastodon URL The URL of the Mastodon instance to connect to (e.g., https://mastodon.social).
Status ID The unique identifier of the Mastodon status (post) to view.

Output

The output is a JSON object representing the Mastodon status retrieved by the given Status ID. This includes all available metadata about the status such as content, author, timestamps, visibility, and any associated media or polls.

If multiple items are returned (not typical for viewing a single status), each item is output as a separate JSON object.

The node does not output binary data for this operation.

Dependencies

  • Requires an API authentication token credential configured in n8n to access the Mastodon API.
  • Needs the Mastodon instance URL to direct API requests correctly.
  • The node depends on the Mastodon API being accessible and the provided Status ID being valid.

Troubleshooting

  • Error: "The operation 'view' for resource 'status' is not implemented!"
    This indicates a misconfiguration or unsupported operation. Ensure the Resource is set to "Status" and Operation to "View Status".

  • Authentication errors
    Verify that the API authentication token is correctly configured and has sufficient permissions to read statuses.

  • Invalid Status ID
    If the Status ID does not exist or is malformed, the Mastodon API will return an error. Double-check the ID value.

  • Connection issues
    Confirm the Mastodon URL is correct and reachable from your environment.

  • Continue On Fail behavior
    If enabled, the node will output error messages in JSON instead of failing the workflow outright.

Links and References

Discussion