Mastodon

Interact with Mastodon API

Actions48

Account Actions
Authentication Actions
Blocks Actions
- Block Account
- Unblock Account
Bookmarks Actions
Favourites Actions
- Favourite
- Unfavourite
Featured Tags Actions
Follow Requests Actions
Media Actions
- Upload Media
- Update Media
Mutes Actions
- Mute Account
- Unmute Account
Notifications Actions
Polls Actions
- View Poll
- Vote on Poll
Status Actions
Timeline Actions

Overview

This node interacts with the Mastodon API to retrieve notifications from a specified Mastodon instance. It is useful for users who want to programmatically access their Mastodon notifications, such as mentions, follows, favourites, reblogs, and polls. Typical scenarios include monitoring social interactions, automating responses, or aggregating notification data for analytics.

For example, you can use this node to fetch the latest notifications from your Mastodon account, filter them by type (e.g., only mentions), or paginate through older notifications.

Properties

Name	Meaning
Mastodon URL	The URL of the Mastodon instance to connect to (e.g., https://mastodon.social). This defines which server the node will query for notifications.
Return All	Whether to return all available notifications or limit the number of results. If false, the number of notifications returned is limited by the "Limit" property.
Limit	The maximum number of notifications to return when "Return All" is false. Must be between 1 and 40.
Additional Fields	Optional parameters to refine the notifications query: • Max ID: Return notifications older than this ID. • Since ID: Return notifications newer than this ID. • Min ID: Return notifications immediately newer than this ID. • Types: Select specific types of notifications to include (Follow, Favourite, Reblog, Mention, Poll). • Exclude Types: Select specific types of notifications to exclude (Follow, Favourite, Reblog, Mention, Poll).

Output

The output is an array of JSON objects, each representing a notification retrieved from the Mastodon instance. Each notification object contains details such as the notification type, related account information, status content if applicable, and timestamps.

The node does not output binary data.

Dependencies

Requires an API authentication token credential configured in n8n to authenticate requests to the Mastodon API.
Needs the URL of the Mastodon instance to connect to.
No additional external dependencies are required beyond the Mastodon API and proper OAuth2 credentials.

Troubleshooting

Common Issues:
- Incorrect Mastodon URL: Ensure the URL is valid and points to a reachable Mastodon instance.
- Authentication errors: Verify that the API authentication token is correctly set up and has sufficient permissions.
- Rate limiting: Mastodon instances may impose rate limits; if too many requests are made in a short time, the node might fail or return partial data.
- Invalid parameter values: For example, setting "Limit" outside the allowed range (1-40) will cause errors.
Error Messages:
- "The operation "get" for resource "notifications" is not implemented!" — indicates a misconfiguration or unsupported operation; ensure the correct resource and operation are selected.
- Network or authentication errors typically indicate issues with connectivity or credentials; check the Mastodon URL and API key.
- Pagination parameters like max_id, since_id, or min_id must be valid IDs; invalid values may result in empty results or errors.