Mastodon icon

Mastodon

Interact with Mastodon API

Overview

This node interacts with the Mastodon API to create a new status (post) on a specified Mastodon instance. It is useful for automating social media posting workflows, such as posting updates, announcements, or replies on Mastodon. For example, it can be used to post a status with text content, attach media, mark the post as sensitive, or set visibility options.

Use Case Examples

  1. Posting a new public status update with text content.
  2. Replying to an existing status by specifying the in-reply-to ID.
  3. Posting a status with attached media by providing media IDs.
  4. Creating a sensitive post with spoiler text and limited visibility.

Properties

Name Meaning
Mastodon URL The URL of the Mastodon instance to connect to for posting the status.
Status Text The text content of the status to be posted.
Additional Fields Optional additional parameters for the status such as media IDs, reply ID, sensitivity flag, spoiler text, and visibility settings.

Output

JSON

  • id - The unique identifier of the created status.
  • created_at - Timestamp when the status was created.
  • content - The HTML content of the status.
  • visibility - Visibility setting of the status.
  • sensitive - Indicates if the status is marked as sensitive.
  • spoiler_text - The spoiler text shown before the status content.
  • media_attachments - List of media attachments associated with the status.

Dependencies

  • Requires an OAuth2 API credential for Mastodon authentication.

Troubleshooting

  • Ensure the Mastodon URL is correct and accessible.
  • Verify that the OAuth2 credentials are valid and have the necessary permissions to post statuses.
  • Check that media IDs provided are valid and belong to the authenticated user.
  • If the status text is empty, the API may reject the request; ensure the status text is provided.
  • Visibility options must be one of the allowed values: public, unlisted, private, or direct.

Links

Discussion