Mastodon icon

Mastodon

Interact with Mastodon API

Actions115

Notifications → Get Notifications

AI-generated

Overview

This node operation fetches notifications from a specified Mastodon instance. It supports retrieving notifications with options to filter by types, exclude certain types, and paginate results using IDs. This is useful for monitoring user interactions such as follows, favourites, reblogs, mentions, and polls on Mastodon.

Use Case Examples

  1. Retrieve the latest 20 notifications from a Mastodon instance.
  2. Fetch all notifications excluding 'follow' and 'poll' types.
  3. Get notifications newer than a specific ID to track recent activity.

Properties

Name Meaning
Mastodon URL URL of the Mastodon instance to connect to.
Authentication Type Method to authenticate with the Mastodon instance, either OAuth2 or Access Token.
Return All Whether to return all notifications or limit the number of results.
Limit Maximum number of notifications to return when 'Return All' is false.
Additional Fields Optional parameters to filter and paginate notifications, including max_id, since_id, min_id, types to include, and types to exclude.

Output

JSON

  • json - The JSON output contains the fetched notifications data from the Mastodon instance, structured as an array of notification objects or a single notification object depending on the query.

Dependencies

  • Requires authentication credentials for Mastodon API, either OAuth2 or an Access Token.

Troubleshooting

  • Ensure the correct authentication type is selected and valid credentials are provided; OAuth2 is required for authentication resource operations.
  • If the node throws an error about an unimplemented operation, verify the resource and operation names are correct.
  • Check the Mastodon instance URL is valid and accessible.
  • If pagination parameters (max_id, since_id, min_id) are used, ensure they are valid IDs from the Mastodon API to avoid empty or incorrect results.

Discussion