Podcode
Sign in
DocsIntegrations

Mastodon

Posts to any Mastodon instance.

Fields

FieldRequiredWhat it is
Instance URLyesThe full URL of your instance, e.g. https://mastodon.social
Access tokenyesA token scoped to posting. Write-only — saved, never shown again.

Connect it

  1. On your instance, go to Settings → Development → New application.
  2. Give it the write:statuses scope. That's all it needs — a token that can only post is a token that can only do the thing you asked for.
  3. Copy the access token.
  4. In Podcode, open Settings → Integrations → Mastodon, enter your instance URL, paste the token, save, then Verify.

The instance URL matters: Mastodon is federated, and the token is only valid on the instance that issued it. If verification fails, that mismatch is the first thing to check.

What it unlocks

  • The post action, which publishes a status and returns its URL.
  • The social agent — see Bluesky for what it does. It works with either integration, or both.

The post limit used is 500 characters, checked before an API call is spent. Instances can configure their own limit; if yours allows more, the shorter of the two applies here.

Re-editing

Reopening the form shows your instance URL but a blank token field. Saving without filling it in keeps the existing token. Enter a new one only to replace it, and revoke the old application on your instance afterwards.

Next

  • Plugins — for capabilities that need code rather than a credential.