Mastodon icon

Mastodon

Interact with Mastodon API

Actions115

Apps → Register Application

AI-generated

Overview

This node operation registers a new application with a specified Mastodon instance. It is useful for developers who want to create and authenticate their own Mastodon applications, enabling them to interact with the Mastodon API using OAuth2 or access tokens. For example, a developer can register their app to obtain client credentials and set redirect URIs for OAuth2 authentication workflows.

Use Case Examples

  1. Register a new Mastodon app by providing the Mastodon instance URL, client name, redirect URIs, requested scopes, and optionally the app's website URL.
  2. Use the registered app credentials to authenticate API requests to the Mastodon instance.

Properties

Name Meaning
Mastodon URL URL of the Mastodon instance to connect to, e.g., https://mastodon.social.
Authentication Type Method to authenticate with the Mastodon instance, either OAuth2 or Access Token.
Client Name Name of the application to register with the Mastodon instance.
Redirect URIs URI(s) where the user will be redirected after authorization, typically used in OAuth2 flows.
Scopes Space-separated list of permission scopes the application requests, e.g., read, write, push.
Website Optional website URL of the application being registered.

Output

JSON

  • json
    • client_id - Client ID assigned to the registered application.
    • client_secret - Client secret assigned to the registered application.
    • redirect_uri - Redirect URI(s) registered for the application.
    • scopes - Scopes granted to the application.
    • website - Website URL of the registered application.

Dependencies

  • Mastodon instance URL and credentials (OAuth2 or Access Token) are required to register the application.

Troubleshooting

  • If OAuth2 credentials are not selected when required, the node throws an error indicating OAuth2 credentials must be used for authentication.
  • If no valid Mastodon credentials are provided, the node throws an error prompting to select appropriate credentials.
  • If the operation or resource is not implemented, an error is thrown indicating the operation is not supported.

Discussion