Implementation guides for multi-tenant social publish.
Deep documentation for Social Relay: quickstart, API authentication, multi-tenant profiles, hosted OAuth, Facebook · Instagram · LinkedIn · Bluesky · Mastodon publish rules, webhooks and HMAC verification, prepaid tokens, rate card math, and security checklists—written for humans and answer engines. Pair with OpenAPI on the API host.
In short
Social Relay publishes 21 implementation guides for multi-tenant social publishing: profiles, hosted OAuth, Facebook · Instagram · LinkedIn publish legs, webhooks, and prepaid tokens. Pair them with OpenAPI on the API host.
21 guides · API base https://api.socialrelay.dev
Getting started
Quickstart: profile → connect → publish
End-to-end Social Relay path: application-scoped API key, profile, hosted connect session, publish with Idempotency-Key, and read per-network legs.
Read guide →Platform dashboard vs production API
When to use the Social Relay dashboard versus server-side API calls for profiles, posts, webhooks, and billing.
Read guide →API hosts, OpenAPI, and official URLs
Canonical Social Relay hosts: marketing site, API base, OpenAPI JSON, OAuth callback, and how to use them in integrations.
Read guide →Authentication & tenancy
Authentication: API keys, profile scope, and dashboard login
How Social Relay separates application-scoped API keys, applications, X-Profile-Id / X-Profile-Grant, Idempotency-Key, and human dashboard sessions.
Read guide →Multi-tenant profiles and externalId mapping
How platforms, profiles, connections, and externalId work in Social Relay for SaaS products that post on behalf of many customers.
Read guide →Connect & OAuth
Hosted connect and OAuth redirect
Create Social Relay connect sessions, brand the hosted UI, handle success and cancel URLs, and use sandbox versus production Meta and LinkedIn OAuth.
Read guide →Sandbox adapters vs live Meta and LinkedIn
When Social Relay uses sandbox network adapters, how to know production OAuth is live, and what changes for app review and publish reliability.
Read guide →Publishing
Publishing posts: validate, legs, partial success, retry
How to create Social Relay posts across Facebook, Instagram, and LinkedIn, interpret leg status, handle partial success, and retry failed networks.
Read guide →Scheduling posts for later publish
How Social Relay scheduleAt works, when tokens are charged, and how to cancel or monitor scheduled multi-network posts.
Read guide →Media guidelines for Facebook, Instagram, and LinkedIn
HTTPS media URL rules, character limits, quotas, and format constraints Social Relay validates before multi-network publish.
Read guide →Idempotency keys for safe publish retries
Why Social Relay requires Idempotency-Key on post create, how keys are scoped, and how to design client retries.
Read guide →Networks
Facebook Pages on Social Relay
How Social Relay publishes to Facebook Pages: prerequisites, media rules, and multi-tenant profile model.
Read guide →Instagram professional accounts on Social Relay
Instagram Graph publishing through Social Relay: Page-linked professional accounts, media requirements, quotas, and caption limits.
Read guide →LinkedIn personal profiles on Social Relay
How Social Relay publishes to LinkedIn personal (member) profiles: connect, media, quotas, and what is out of scope.
Read guide →Bluesky on Social Relay
How Social Relay connects Bluesky accounts and publishes AT Protocol posts with optional images.
Read guide →Mastodon on Social Relay
Multi-instance Mastodon connect and status publishing through Social Relay.
Read guide →Webhooks & reliability
Webhooks: events, HMAC signature, deliveries, redrive
Register Social Relay webhooks, verify X-Social-Restapi-Signature, handle post and connection events, and redrive failed deliveries.
Read guide →Errors, partial posts, and safe retries
Social Relay error envelope, common codes, partial multi-network posts, and how to retry without double publishing.
Read guide →Billing & tokens
Security & limits
API limits and fair use
Social Relay product rate limits, per-account network quotas, publish concurrency, duplicate content rules, daily token budget, and how to handle 429/409 in your SaaS.
Read guide →Integrator security checklist
Best practices for integrating Social Relay safely: key storage, TLS, webhooks, multi-tenant mapping, and rate limits.
Read guide →Also useful
- Pricing & rate card — token costs and packs from the live backend catalog
- Developers — API host and OpenAPI entry points
- FAQ — plain-language product answers
- How it works — profile → connect → publish flow