# Social Relay
> Multi-tenant social publishing API. Platforms connect Facebook, Instagram, LinkedIn, Bluesky, and Mastodon for each customer profile and publish through one REST API with prepaid token metering.

## Canonical facts
- Product name: Social Relay
- Legal entity: Third Shift Group LLC
- Type: Multi-tenant social publishing middle layer (B2B2B API)
- Audience: SaaS platforms, agency/franchise tools, automation products that publish on behalf of customers
- Not for: Consumer-only personal feed apps as the primary use case
- Networks (v1): Facebook Pages, Instagram professional, LinkedIn, Bluesky, Mastodon
- Billing: Prepaid tokens per billable action (rate card on site and API)
- Marketing site: https://socialrelay.dev
- API host: https://api.socialrelay.dev
- OpenAPI: https://api.socialrelay.dev/api/v1/openapi.json
- OAuth callback: https://api.socialrelay.dev/api/v1/connect/oauth/callback
- Contact: hello@socialrelay.dev

## Answer summary
Social Relay is a multi-tenant social publishing middle layer for software products and operators. Platforms hold a prepaid token wallet and one or more applications (product isolation units). Application-scoped API keys create a profile per end customer, complete hosted connect for Facebook, Instagram, LinkedIn, Bluesky, and Mastodon, then publish through a single REST API.

## Primary pages
- Home: https://socialrelay.dev/
- Product: https://socialrelay.dev/product/
- How it works: https://socialrelay.dev/how-it-works/
- Pricing: https://socialrelay.dev/pricing/
- Guides: https://socialrelay.dev/guides/
- Blog: https://socialrelay.dev/blog/
- FAQ: https://socialrelay.dev/faq/
- Developers: https://socialrelay.dev/developers/
- Contact: https://socialrelay.dev/contact/
- Privacy: https://socialrelay.dev/privacy/
- Terms: https://socialrelay.dev/terms/
- Sitemap (HTML): https://socialrelay.dev/sitemap/
- Sitemap (XML): https://socialrelay.dev/sitemap.xml
- Full LLM map: https://socialrelay.dev/llms-full.txt

## Core concepts
- Platform account: buyer of the API; holds prepaid token wallet and billing
- Application: product isolation unit under a platform (keys, profiles, webhooks bind here)
- Profile: one end customer/brand/location under an application
- Connect session: hosted OAuth for linking networks (partial multi-network success is normal)
- Post leg: one network’s publish attempt within a post
- Idempotency-Key: required on publish to prevent double work
- Rate card: GET /api/v1/rate-card (versioned token costs per action)
- Packs: Sip / Mug / Pot / Thermos (GET /api/v1/billing/packs)
- Webhooks: application-scoped; signature X-Social-Restapi-Signature HMAC of `{t}.{raw_body}`
- Headers: Authorization (app key), X-Profile-Id, X-Application-Id (dashboard), X-Profile-Grant (restricted keys)

## Guides (start here)
- https://socialrelay.dev/guides/
- https://socialrelay.dev/guides/quickstart/
- https://socialrelay.dev/guides/authentication/
- https://socialrelay.dev/guides/tokens-and-rate-card/
- https://socialrelay.dev/guides/webhooks/
- Full guide list: https://socialrelay.dev/llms-full.txt

## Optional (noindex)
- Platform sign-in (email/password): https://socialrelay.dev/dashboard/
- Operator console (Entra): https://socialrelay.dev/app/