Integrations / Mastodon

Mastodon integration
for VeloCMS

Publish a post on VeloCMS and it lands on your Mastodon instance automatically — title, excerpt, and a link back to the post, no copy-paste, no separate crossposting tool.

Get started

What this integration does

The Mastodon Cross-Post connector listens for the post:afterPublish hook. When a post is published, it builds a status — post title, an excerpt if there is room within Mastodon's 500-character limit, and the canonical public URL of the post — and sends it to your configured Mastodon instance via POST /api/v1/statuses, publicly visible. Every request carries a deterministic Idempotency-Key derived from the post ID, so if a retry fires after an ambiguous network failure, Mastodon returns the original status instead of creating a duplicate toot. If the instance URL or access token is not configured, publishing proceeds normally and the crosspost is skipped — a Mastodon outage never blocks your post from going live.

Auto-post on publish

Every published post sends a status to your Mastodon instance automatically — title, excerpt, and link.

Idempotent retry

A retry after a network hiccup reuses the same Idempotency-Key, so Mastodon returns the original status instead of a duplicate toot.

Fail-soft by design

Missing credentials or a Mastodon error is logged and skipped — it never blocks the post from publishing.

Where to find it in admin

  1. 1
    Admin → Plugins → Mastodon. Enter your Mastodon instance URL and paste an access token with write permission on statuses.
  2. 2
    Save. The next post you publish crossposts automatically. Connector activity — success or failure — is visible in the plugin's activity log.

Use cases

A newsletter writer growing a fediverse following crossposts every article the moment it goes live, without opening a second tab. A publication running its own Mastodon instance uses the connector to keep its status feed in lockstep with its blog. A solo blogger who prefers Mastodon over centralized social networks gets the same reach as an X or LinkedIn crosspost without switching platforms.

Also see the Bluesky integration and LinkedIn integration.

Publish once, reach the fediverse too.

14-day free trial. Connect Mastodon and every future post crossposts automatically.

Get started with VeloCMS