Mastodon icon

Mastodon

Interact with Mastodon API

Overview

This node allows interaction with the Mastodon social network API, specifically focusing on managing favourites (likes) of statuses. The "Favourite" operation under the "Favourites" resource enables users to mark a specific status as a favourite on a Mastodon instance.

Common scenarios where this node is beneficial include automating social media engagement workflows, such as automatically liking posts that meet certain criteria or integrating Mastodon favourites into broader automation pipelines.

Practical example: Automatically favourite a status when it contains a specific hashtag or keyword, helping to boost visibility or track important content.

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 status (post) to be favourited.

Output

The output JSON contains the response from the Mastodon API after favouriting the specified status. This typically includes details about the status itself, including its current favourite count and whether it is favourited by the authenticated user.

No binary data output is involved in this operation.

Dependencies

  • Requires an API authentication token credential for Mastodon OAuth2.
  • Needs the URL of the target Mastodon instance.
  • The node depends on the Mastodon API being accessible and the provided credentials having permission to favourite statuses.

Troubleshooting

  • Common issues:

    • Invalid or missing Mastodon instance URL can cause connection failures.
    • Incorrect or expired API authentication tokens will result in authorization errors.
    • Providing an invalid or non-existent Status ID will cause the operation to fail.
  • Error messages:

    • "The operation "favourite" for resource "favourites" is not implemented!" — indicates a misconfiguration or unsupported operation; ensure correct resource and operation are selected.
    • Network or authentication errors usually indicate problems with credentials or instance URL.
  • Resolutions:

    • Verify the Mastodon URL is correct and reachable.
    • Ensure the API key or OAuth token is valid and has appropriate permissions.
    • Confirm the Status ID exists on the given Mastodon instance.

Links and References

Discussion