Quickstart: ship your first post

Connect a channel, draft a post, and publish in under five minutes.

Updated May 12, 2026·1 min read

Welcome to Unison. This walkthrough takes you from a fresh sign-up to your first live post on a real social network.

1. Connect a channel

  1. 1

    Open Settings → Channels and click Add channel. Pick the network you want to publish to first. Most people start with X because the OAuth flow is the fastest.

  2. 2

    You will be redirected to the network's authorisation page. Approve the request and you land back inside Unison with the new channel listed.

  3. 3

    Repeat for any additional channels. Connections are stored encrypted at rest. See Security for details.

App passwords

Bluesky uses an app password instead of OAuth. Generate one in your Bluesky settings, then paste it into Unison.

2. Compose a post

The composer lives at the top of every dashboard view. Type your draft on the left, watch the live preview update on the right.

ts
// You can also script posts via the API once you upgrade to Pro.
import { createPost } from '@unison/sdk';
 
await createPost({
  channels: ['x', 'bluesky'],
  body: 'Shipping our first post via the SDK.',
});

Toggle additional networks on under the composer header. Unison auto-splits long bodies into platform-appropriate threads where character limits demand it.

Image uploads are capped at 8 MB per file. We auto-optimise but won't resize beyond what each network's API accepts.

3. Schedule or publish

Press Publish now to ship immediately, or open the date picker to schedule. Anything scheduled lands in the Queue and can be reordered, edited, or cancelled before it goes out.

That is it. You have shipped your first post.

Was this helpful?