Mastodon

Interact with Mastodon API

Actions115

Account Actions
- View User Profile
- Verify Credentials
- Unpin Account
- Unmute Account
- Search Accounts
- Remove Account from Followers
- Pin Account
- Get Featured Tags
- Get Account Statuses
- Get Account Lists
- Get Account Following
- Get Account Followers
- Add Note to Account
Announcements Actions
- List
Apps Actions
- Register Application
- Verify Credentials
Authentication Actions
- Register Application
- Obtain Token
- Revoke Token
Blocks Actions
- Block Account
- Unblock Account
Bookmarks Actions
- Get Bookmarked Statuses
- Add Bookmark
- Remove Bookmark
Canonical Email Blocks Actions
- List Blocks
- Get Block
Cohorts Actions
- Get Retention Data
Conversations Actions
- Get All Conversations
- Remove Conversation
- Mark as Read
Custom Emojis Actions
- List
Directory Actions
- View
Domains (Allowed) Actions
- List Allowed Domains
- Get Allowed Domain
Domains (Blocked) Actions
- List Blocked Domains
- Get Blocked Domain
- Block Domain
Domains (Email Blocked) Actions
- List Email Blocked Domains
- Get Email Blocked Domain
- Block Email Domain
Emails Actions
- Resend Confirmation
Endorsements Actions
- Get Endorsements
Favourites Actions
- Get Favourites
- Favourite
- Unfavourite
Featured Tags Actions
- Get Featured Tags
- Feature Tag
- Unfeature Tag
Filters Actions
- Create Filter
- Update Filter
- Delete Filter
Follow Requests Actions
- Get Follow Requests
- Authorize Follow Request
- Reject Follow Request
Followed Tags Actions
- Get Followed Tags
Instance Actions
- Get Server Information
IPs Actions
- List IPs
- Get IP
Lists Actions
- Get Lists
- Get List
- Create List
- Update List
- Delete List
- Get Accounts in List
- Add Accounts to List
- Remove Accounts from List
Markers Actions
- Get Markers
- Save Markers
Measures Actions
- List Measures
- Get Measure Metrics
Media Actions
- Upload Media
- Update Media
Mutes Actions
- Mute Account
- Unmute Account
Notifications Actions
- Get Notifications
- Dismiss Notification
- Get Unread Count
oEmbed Actions
- Fetch oEmbed Data
Polls Actions
- View Poll
- Vote on Poll
Preferences Actions
- Get User Preferences
Profile Actions
- Delete Avatar
- Delete Header
Proofs Actions
- List Identity Proofs
Push Actions
- Subscribe to Push Notifications
- Get Current Subscription
- Update Subscription
- Delete Subscription
Reports Actions
- List Reports
- Resolve Report
- Create Report
Retention Actions
- View Statistics
Scheduled Statuses Actions
- List Scheduled Statuses
- View Scheduled Status
- Update Scheduled Status
- Cancel Scheduled Status
Search Actions
- Search
Status Actions
- Create Status
- Delete Status
- Edit Status
- View Status
- Get Context
Streaming Actions
- Stream Public Timeline
- Stream Hashtag Timeline
- Stream User Timeline
Suggestions Actions
- Get Suggestions
- Remove Suggestion
Tags Actions
- Get Tag Information
- Follow Tag
- Unfollow Tag
Timeline Actions
- Get Public Timeline
- Get Hashtag Timeline
- Get Home Timeline
- Get List Timeline
- Get Link Timeline

Push → Subscribe to Push Notifications

AI-generated

Overview

This node operation subscribes to push notifications from a specified Mastodon instance. It allows users to provide subscription details such as the endpoint URL and cryptographic keys required for push notification delivery. Users can also configure which types of alerts they want to receive, such as mentions, new statuses, boosts, follows, and various admin notifications. This operation is useful for applications or workflows that need to receive real-time updates and notifications from a Mastodon instance via push notifications.

Use Case Examples

A social media monitoring tool subscribing to mentions and new statuses to alert users in real-time.
An admin dashboard subscribing to new sign-ups and reports notifications to manage community activities efficiently.

Properties

Name	Meaning
Mastodon URL	URL of the Mastodon instance to connect to, used to specify the target server for push notifications.
Authentication Type	Method to authenticate with the Mastodon instance, either OAuth2 or Access Token.
Subscription	Details of the push notification subscription including endpoint URL and cryptographic keys (P256DH key and Auth secret) required for push notification delivery.
Alerts	Settings to specify which types of notifications to receive, such as mentions, new statuses, boosts, follows, follow requests, favourites, polls, status updates, and admin notifications for new sign-ups and reports.
Additional Fields	Optional additional fields such as notification delivery policy to customize the subscription behavior.

Output

JSON

endpoint - The endpoint URL to receive push notifications.
keys
- p256dh - User agent public key (Base64 encoded) used for push subscription.
- auth - Auth secret (Base64 encoded) used for push subscription.
alerts
- mention - Boolean indicating if notifications for mentions are enabled.
- status - Boolean indicating if notifications for new statuses are enabled.
- reblog - Boolean indicating if notifications for boosts are enabled.
- follow - Boolean indicating if notifications for follows are enabled.
- follow_request - Boolean indicating if notifications for follow requests are enabled.
- favourite - Boolean indicating if notifications for favourites are enabled.
- poll - Boolean indicating if notifications for polls are enabled.
- update - Boolean indicating if notifications for status updates are enabled.
- admin
  * sign_up - Boolean indicating if admin notifications for new sign-ups are enabled.
  * report - Boolean indicating if admin notifications for new reports are enabled.
additionalFields
- policy - Optional notification delivery policy for the subscription.

Dependencies

Mastodon instance URL and authentication credentials (OAuth2 or Access Token) are required to connect and subscribe to push notifications.

Troubleshooting

Ensure that the correct authentication type is selected and corresponding credentials are provided; OAuth2 is required for some operations.
Verify that the Mastodon instance URL is correct and accessible.
Check that the subscription endpoint URL and keys are correctly provided and properly encoded in Base64.
If the node throws an error about an unimplemented operation, verify that the resource and operation names are correctly set.

MastodonInstall