Mastodon icon

Mastodon

Interact with Mastodon API

Overview

This node allows users to create a new status (a post) on a Mastodon instance. Mastodon is a decentralized social network platform, and this node interacts with its API to publish statuses programmatically.

Typical use cases include:

  • Automating social media posting workflows.
  • Cross-posting content from other platforms or data sources.
  • Scheduling or triggering posts based on external events or data changes.

For example, you could use this node to automatically post updates about your blog, share alerts from monitoring systems, or publish announcements to your Mastodon followers.

Properties

Name Meaning
Mastodon URL The URL of the Mastodon instance where the status will be posted (e.g., https://mastodon.social).
Status Text The main text content of the status to be published.
Additional Fields Optional extra parameters for the status:
- Media IDs Comma-separated list of media attachment IDs to include in the status.
- In Reply To ID ID of an existing status to which this new status is a reply.
- Sensitive Boolean flag to mark the status and attached media as sensitive content.
- Spoiler Text Text shown as a warning or subject before the actual status content (content warning).
- Visibility Controls who can see the status; options are: Public, Unlisted, Private, Direct.

Output

The node outputs JSON data representing the created status object returned by the Mastodon API. This typically includes details such as:

  • The unique ID of the status.
  • The full text content.
  • Metadata like creation time, visibility, sensitivity flags.
  • Attached media information if any.
  • Reply relationships if applicable.

No binary data output is involved.

Dependencies

  • Requires an API authentication token credential configured for the Mastodon instance.
  • Needs the Mastodon instance URL to connect to.
  • The node depends on the Mastodon REST API being accessible and the provided credentials having permission to post statuses.

Troubleshooting

  • Common issues:

    • Invalid or missing Mastodon instance URL.
    • Incorrect or expired API authentication token.
    • Posting a status with invalid media IDs or malformed parameters.
    • Network connectivity problems to the Mastodon server.
  • Error messages:

    • "The operation "create" for resource "status" is not implemented!" — indicates a misconfiguration or unsupported operation.
    • API errors returned from Mastodon (e.g., unauthorized, bad request) will be surfaced; ensure credentials and parameters are correct.
    • If the node fails but "Continue On Fail" is enabled, it returns an error message in the output JSON.
  • Resolutions:

    • Verify the Mastodon URL is correct and reachable.
    • Check that the API token has the necessary scopes/permissions.
    • Validate all input fields, especially media IDs and reply IDs.
    • Enable detailed logging or inspect API responses for more info.

Links and References

Discussion