Overview
This n8n node allows you to interact with the Mastodon API, specifically to "boost" (reblog/share) a status on a Mastodon instance. The "Boost" operation for the "Status" resource enables users to amplify a specific post by its ID, making it visible to their followers. This is useful for social media automation, such as automatically sharing important updates or amplifying content from certain accounts.
Example scenarios:
- Automatically boosting posts from a monitored account.
- Creating workflows that share trending statuses based on custom logic.
- Integrating Mastodon engagement into broader social media automation pipelines.
Properties
| Name | Type | Meaning |
|---|---|---|
| Mastodon URL | String | The base URL of the Mastodon instance you want to connect to. |
| Status ID | String | The unique identifier of the status (post) you wish to boost (reblog). |
Output
The node outputs a JSON object containing the response from the Mastodon API after attempting to boost the specified status. The structure typically includes details about the boosted status, such as its ID, content, author, and engagement metrics. The exact fields depend on the Mastodon API's response for a status boost action.
Dependencies
- External Service: Requires access to a Mastodon instance via its public API.
- Authentication: Optionally uses OAuth2 credentials (
mastodonOAuth2Api) if required by the Mastodon instance. - n8n Configuration: No special environment variables are needed unless your Mastodon instance requires custom authentication settings.
Troubleshooting
Common Issues:
- Invalid Mastodon URL: Ensure the Mastodon URL is correct and accessible.
- Incorrect Status ID: Double-check the Status ID; an invalid or deleted status will cause errors.
- Authentication Errors: If the Mastodon instance requires authentication, ensure valid OAuth2 credentials are configured in n8n.
- API Rate Limits: Excessive requests may trigger rate limiting on some Mastodon instances.
Error Messages:
"Status not found": The provided Status ID does not exist. Verify the ID."Unauthorized": Authentication failed. Check your credentials."Instance unreachable": The Mastodon URL is incorrect or the server is down.