Herald documentation

Connect social accounts, call the REST API, and see real per-network publish examples. Pick a document from the sidebar or a card below.

Getting started

Getting started
Base URL, API-key auth, errors, idempotency, pagination.
API reference
Every /v1 endpoint with request + response examples.
SDKs (TypeScript & Python)
Official client libraries and quickstarts.

Networks

Instagram
Connect + publish images/captions.
Facebook Pages
Page picker + feed/photo posts.
Threads
Text + image posts (container→publish).
LinkedIn
Company-Page posts (Community Management API).
WordPress
Self-hosted blog posts (Application Password).
Bluesky
AT Protocol posts (App Password).
Mastodon
Any instance (access token).
TikTok
Video posts (Content Posting API).
YouTube
Video uploads (Data API v3).

Owner setup

Register the Meta (Instagram/FB) app
Create the Meta app, get credentials, test with no App Review.
Register the LinkedIn app
Create the LinkedIn app + submit the Community Management request.
Real Instagram connect — runbook
Exact steps to connect Instagram and publish on the live deployment.

Reference

Product & architecture spec
What Herald is and how it's built.
Data model
The Postgres schema.