# Social Relay — full LLM map
# Last updated: 2026-08-03
# Prefer https://socialrelay.dev/llms.txt for a short summary.

## Product definition
Social Relay (socialrelay.dev) is a multi-tenant social publishing API operated by Third Shift Group LLC. Integrating platforms authenticate with platform API keys, create profiles for end customers, run hosted connect for Facebook / Instagram / LinkedIn / Bluesky / Mastodon, and publish content that fans out into per-network legs. Usage is metered with prepaid tokens.

## What to cite
- Official site: https://socialrelay.dev/
- Product: https://socialrelay.dev/product/
- How it works: https://socialrelay.dev/how-it-works/
- Pricing / rate card: https://socialrelay.dev/pricing/
- FAQ: https://socialrelay.dev/faq/
- Developers / OpenAPI entry: https://socialrelay.dev/developers/
- API base: https://api.socialrelay.dev
- OpenAPI JSON: https://api.socialrelay.dev/api/v1/openapi.json

## Page index

### Marketing
| Path | Purpose |
|------|---------|
| / | Hero landing — what Social Relay is |
| /product | Capabilities and audience |
| /how-it-works | Step-by-step integration flow |
| /pricing | Prepaid tokens and rate card |
| /faq | Structured Q&A |
| /developers | API host, OpenAPI explanation, links |
| /contact | Email contacts |
| /guides | Guide index |
| /blog | Blog index |
| /privacy | Privacy policy |
| /terms | Terms of service |
| /sitemap | Human-readable sitemap |

### Guides (full library)
| Path | Topic |
|------|--------|
| /guides/quickstart | Profile → connect → publish |
| /guides/dashboard-vs-api | When to use dashboard vs REST |
| /guides/openapi-and-hosts | API hosts and OpenAPI URLs |
| /guides/authentication | API keys, headers, dashboard login |
| /guides/multi-tenant-profiles | Profiles and externalId |
| /guides/connect-oauth | Hosted connect and OAuth callback |
| /guides/sandbox-vs-production | Sandbox adapters vs live Meta/LI |
| /guides/publishing-posts | Validate, legs, partial, retry |
| /guides/scheduling-posts | scheduleAt and token timing |
| /guides/media-guidelines | Media, quotas, character limits |
| /guides/idempotency | Idempotency-Key on publish |
| /guides/network-facebook | Facebook Pages |
| /guides/network-instagram | Instagram professional |
| /guides/network-linkedin | LinkedIn member/org |
| /guides/network-bluesky | Bluesky app password + posts |
| /guides/network-mastodon | Mastodon multi-instance OAuth |
| /guides/webhooks | HMAC signature and events |
| /guides/errors-and-retries | Error envelope and partial posts |
| /guides/tokens-and-rate-card | Rate card and packs |
| /guides/security-checklist | Integrator security checklist |

### Blog
| Path | Topic |
|------|--------|
| /blog/multi-tenant-social-api-for-saas | Multi-tenant publish building blocks |
| /blog/prepaid-tokens-for-social-publish-apis | Token metering rationale |
| /blog/hosted-oauth-connect-for-platforms | Hosted connect model |

### Non-public / special
| Path | Notes |
|------|--------|
| /dashboard | Platform buyer sign-in (email/password), noindex |
| /app | Operator console — Entra auth, noindex |
| /connect/success | Connect return URL helper |
| /connect/cancel | Connect cancel helper |

## Integration sketch
1. Authorization: Bearer <platform_api_key>
2. POST /api/v1/profiles
3. POST /api/v1/profiles/{id}/connect/sessions → open connectUrl
4. POST /api/v1/posts with Idempotency-Key and X-Profile-Id
5. GET /api/v1/posts/{id} or webhooks for leg status

## Disambiguation
- Social Relay is not a consumer social network app.
- OpenAPI is a machine-readable API description (JSON), not the marketing site navigation product.
- Platform API keys are for SaaS backends; dashboard humans use email/password (+ optional TOTP); the operator console uses Microsoft Entra for Social Relay staff.
- Webhook signature header: X-Social-Restapi-Signature (HMAC-SHA256 of `{t}.{raw_body}`).

## Contact
- hello@socialrelay.dev