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 such as accounts, statuses, timelines, media, and more. For the Account resource with the Verify Credentials operation, it verifies the validity of the provided Mastodon instance URL and associated credentials by checking the account's authentication status.

Common scenarios where this node is beneficial include:

  • Validating user credentials before performing further actions on a Mastodon instance.
  • Automating workflows that require confirmation of account access.
  • Integrating Mastodon account verification into larger automation pipelines.

Practical example:

  • Before posting a status update or fetching timeline data, use this node to verify that the API credentials and Mastodon instance URL are correct and accessible.

Properties

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

Output

The output JSON contains the response from the Mastodon API related to the account verification. Typically, this includes details about the authenticated user account, confirming that the credentials and URL are valid.

The structure generally includes fields such as:

  • Account ID
  • Username
  • Display name
  • Avatar URL
  • Other profile metadata returned by the Mastodon API for the authenticated user

No binary data output is involved in this operation.

Dependencies

  • Requires an API key credential configured for OAuth2 authentication with the Mastodon instance.
  • The node expects the Mastodon instance URL to be provided as input.
  • Network connectivity to the specified Mastodon instance is necessary.
  • No additional external services beyond the Mastodon API are required.

Troubleshooting

  • Invalid URL or unreachable Mastodon instance:
    Ensure the Mastodon URL is correct and the instance is online. Use a browser or curl to verify accessibility.

  • Authentication failures:
    Verify that the OAuth2 credentials are correctly set up and have the necessary permissions on the Mastodon instance.

  • Operation not implemented error:
    If you receive an error stating the operation is not implemented, confirm that the selected resource is "Account" and the operation is "Verify Credentials".

  • Network errors or timeouts:
    Check your internet connection and firewall settings to ensure requests to the Mastodon instance are allowed.

  • Continue on Fail behavior:
    If enabled, the node will return an error message in the output JSON instead of failing the workflow outright.

Links and References

Discussion