# Connect a Mastodon instance and choose post visibility

> Authorise a public HTTPS Mastodon server, verify the account and publish text or supported images with the intended visibility.

Canonical HTML: https://proplix.co.uk/help-centre/social-automation-connect-mastodon/

Topic: Social Media Automation

Reviewed: 13 November 2026

## Where to start

Social accounts → Mastodon; Configuration where applicable

## Before you begin

An authorised account on a publicly reachable HTTPS Mastodon instance. You do not need to paste a pre-created global client secret into Configuration.

## Fields and options

- **Access needed:** Manage connections; administrator for app credentials; Create posts + Publish posts for a live test
- **Requested OAuth permissions:** read:accounts, write:statuses and write:media. These are the scopes requested by the current adapter; provider products/review must permit them.
- **Destination and scope:** Application credentials are stored per instance. Internal hostnames, loopback/private addresses and unsafe destinations are rejected; this is not a connector to an internal HTTP service.
- **Publishing format:** Use supported text or images, keep composed text within this adapter’s 500-character limit and choose Public, Unlisted or Followers only. Video publication is not supported here.

## Follow these steps

1. Enter the public instance hostname in the Mastodon connection flow. The module registers an application for that instance and opens its official consent page. Approve the intended account.
2. In Social accounts, choose Verify connection and compare the account or destination identity with the intended test account.
3. Use supported text or images, keep composed text within this adapter’s 500-character limit and choose Public, Unlisted or Followers only. Video publication is not supported here.
4. When a controlled test is authorised and the direct gate is enabled, select only this destination, choose Post Now once and inspect its existing receipt.

## Check the result

Open the account on that instance and verify the final post and visibility. Image processing may need reconciliation before the post is ready. Match the actual provider outcome to the destination receipt, remote reference and intended visibility.

## Troubleshooting

If registration or consent fails, check public HTTPS reachability, instance app-registration policy and authorised scopes. Do not work around a rejected internal hostname. Do not repeat Post Now after an ambiguous result until the original provider outcome has been checked.

## Fields, rules and limits

- Saving credentials or passing connection verification does not prove that a live publication succeeded.
- Use a dedicated test destination and the most restrictive appropriate visibility. Provider consent, app review and organisational approvals remain separate requirements.

## Questions and answers

### Does a connected account mean publishing is approved?

No. Connection identity, app publishing entitlement, content eligibility and the separate direct-publishing gate are independent checks.

### What is a complete first test?

Official consent, correct destination discovery, successful verification, one deliberate test publication, a destination receipt and direct verification in the actual provider account.


## Related guidance

- [Social Media Automation: account setup to verified publication](https://proplix.co.uk/help-centre/social-automation-complete-feature-guide/index.md)
- [Configure social provider apps and exact OAuth callback URLs](https://proplix.co.uk/help-centre/social-automation-provider-app-settings/index.md)
- [Publish with Post Now and verify every destination receipt](https://proplix.co.uk/help-centre/social-automation-post-now-receipts/index.md)

Product reference: https://britixo.com/help-centre/social-automation-connect-mastodon/
