Getting started

Quickstart

Create a key, connect a network, and publish your first post — in about three minutes.

Pick the fast lane

Bluesky, Telegram, and Discord publish the instant you paste a credential — no developer app, no review. This walkthrough uses Bluesky. The OAuth networks work identically once connected.

Step 1 — Create an API key

In the dashboard, open Settings → API keys and create one. The secret is shown once — copy it into your environment right away. Then confirm it works against Get current user.

export POSTMYISH_KEY="pmi_live_9f2c8b1e…"

# Verify the key
curl https://postmyish.com/api/v1/me \
  -H "Authorization: Bearer $POSTMYISH_KEY"

Step 2 — Connect a network

Connect the networks you want to publish to from the dashboard’s Accounts page. Each of the twelve has a short setup guide — start with Bluesky for the quickest path. Then read them back over the API to confirm what you can publish to:

curl https://postmyish.com/api/v1/accounts \
  -H "Authorization: Bearer $POSTMYISH_KEY"

Only networks that appear here can be targeted — the API silently drops ids you haven’t connected.

Step 3 — Publish your first post

One POST fans your caption out to every network you name. Leave out schedule_at and it publishes immediately.

curl -X POST https://postmyish.com/api/v1/posts \
  -H "Authorization: Bearer $POSTMYISH_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "caption": "Hello from PostMyIsh 👋",
    "platforms": ["bluesky"]
  }'

Schedule it instead

Add schedule_at — a Unix timestamp or an ISO 8601 string in the future — and the post is queued rather than published. A publisher runs every minute and ships it at the right time.

{
  "caption": "Morning, every feed ☀️",
  "platforms": ["bluesky", "telegram", "discord"],
  "schedule_at": "2026-08-01T09:00:00Z"
}

The response comes back with status: "scheduled". Learn more in Scheduling & the queue.

Where to go next