Mastodon icon

Mastodon

Interact with Mastodon API

Overview

This node interacts with the Mastodon API, specifically to manage and retrieve follow requests when using the "Follow Requests" resource with the "Get Follow Requests" operation. It is useful for users who want to automate monitoring or processing of incoming follow requests on their Mastodon instance.

Typical use cases include:

  • Automatically fetching pending follow requests to review or log them.
  • Integrating Mastodon follow request data into other workflows or databases.
  • Triggering notifications or actions based on new follow requests.

For example, a user could set up this node to periodically check for new follow requests on their Mastodon account hosted at a specific instance URL and then process those requests further in an automation workflow.

Properties

Name Meaning
Mastodon URL The URL of the Mastodon instance to connect to (e.g., https://mastodon.social). This specifies which Mastodon server the node will interact with.

Output

The node outputs JSON data representing the follow requests retrieved from the specified Mastodon instance. The structure typically includes details about each follow request such as the requesting user's account information and status.

If multiple follow requests are returned, the output will be an array of JSON objects, each corresponding to one follow request.

No binary data output is indicated for this operation.

Dependencies

  • Requires an API authentication token credential configured in n8n to authenticate with the Mastodon instance.
  • Needs the Mastodon instance URL provided by the user to direct API calls correctly.
  • Relies on the Mastodon API being accessible and the authenticated user having permission to view follow requests.

Troubleshooting

  • Common issues:

    • Incorrect or missing Mastodon instance URL can cause connection failures.
    • Invalid or expired API authentication token will result in authorization errors.
    • If the authenticated user does not have permission to access follow requests, the API may return errors or empty results.
  • Error messages:

    • "The operation "Get Follow Requests" for resource "Follow Requests" is not implemented!" — indicates a misconfiguration or unsupported operation; verify the selected resource and operation.
    • Network or authentication errors usually indicate problems with credentials or instance URL; ensure these are correct and valid.
  • Resolution tips:

    • Double-check the Mastodon URL format and accessibility.
    • Refresh or reconfigure the API authentication token credential.
    • Confirm that the Mastodon user has appropriate permissions to access follow requests.

Links and References

Discussion