Mastodon icon

Mastodon

Interact with Mastodon API

Overview

This node allows interaction with the Mastodon social network API, specifically enabling operations on various Mastodon resources. For the Featured Tags resource with the Feature Tag operation, it lets you mark a specific hashtag as featured on a given Mastodon instance.

Practical scenarios include:

  • Highlighting trending or important hashtags on your Mastodon instance.
  • Automating the promotion of community tags for events or campaigns.
  • Managing featured tags programmatically without manual intervention in the Mastodon UI.

Example: Automatically feature the hashtag #n8n on your Mastodon instance to increase its visibility.

Properties

Name Meaning
Mastodon URL The URL of the Mastodon instance where the tag will be featured (e.g., https://mastodon.social).
Tag Name The name of the hashtag to feature (without the # symbol).

Output

The node outputs JSON data representing the result of the feature tag operation. This typically includes confirmation details from the Mastodon API about the featured tag status or any metadata returned by the API after successfully featuring the tag.

No binary data output is involved.

Dependencies

  • Requires an API authentication token credential for the Mastodon instance (OAuth2-based).
  • Needs the Mastodon instance URL to connect and perform the operation.
  • The node depends on the Mastodon API being accessible and the authenticated user having permission to feature tags.

Troubleshooting

  • Common issues:

    • Incorrect Mastodon URL or unreachable instance.
    • Insufficient permissions to feature tags on the Mastodon instance.
    • Invalid or expired API authentication token.
    • Specifying a tag name that does not exist or is malformed.
  • Error messages:

    • "The operation "feature" for resource "featuredTags" is not implemented!" — indicates a misconfiguration or unsupported operation; ensure correct resource and operation names.
    • Network or authentication errors — verify credentials and instance URL.
    • API errors related to permissions — check user roles and API scopes on the Mastodon instance.

Resolving these usually involves verifying the Mastodon URL, refreshing or reconfiguring credentials, and ensuring the tag name is valid.

Links and References

Discussion