# Aether

> Aether is a unified social media API platform. Developers integrate once
> and get publish, schedule, inbox, automations, analytics, and webhooks
> across social platforms via REST API and MCP server.

## API Base URL
https://api.aetherhq.dev/v1

## Authentication
All requests require: Authorization: Bearer aeth_live_<key>

## OpenAPI Spec
https://api.aetherhq.dev/v1/openapi.yaml

## Full Documentation for LLMs
https://docs.aetherhq.dev/llms-full.txt

## Overview
- [Quickstart](https://docs.aetherhq.dev/docs/overview/getting-started/quickstart): Authenticate, connect accounts, and schedule your first post in minutes.
- [Analytics](https://docs.aetherhq.dev/docs/overview/guides/analytics): Post and account metrics powered by Tinybird.
- [Authentication](https://docs.aetherhq.dev/docs/overview/guides/authentication): API keys, scopes, and organization access for the Aether API.
- [Automations](https://docs.aetherhq.dev/docs/overview/guides/automations): Comment-to-DM and story-reply automation rules with keyword matching.
- [Connect Links](https://docs.aetherhq.dev/docs/overview/guides/connect-links): Magic OAuth URLs that let users connect social accounts without implementing OAuth.
- [Errors](https://docs.aetherhq.dev/docs/overview/guides/errors): API error format, common codes, and how to handle failures.
- [Inbox](https://docs.aetherhq.dev/docs/overview/guides/inbox): Unified inbox for DMs, comments, mentions, and replies across platforms.
- [Media](https://docs.aetherhq.dev/docs/overview/guides/media): Upload images and videos via presigned URLs for use in posts.
- [Publishing](https://docs.aetherhq.dev/docs/overview/guides/publishing): Cross-platform posting, scheduling, queues, and per-platform content overrides.
- [Queues](https://docs.aetherhq.dev/docs/overview/guides/queues): Org-level recurring publish slot schedules for automatic post timing.
- [Webhooks](https://docs.aetherhq.dev/docs/overview/guides/webhooks): Receive real-time event notifications from Aether via HTTP callbacks.

## Platforms
- [Facebook](https://docs.aetherhq.dev/docs/platforms/facebook): Facebook Page publishing, carousel posts, inbox, and comment-to-DM on Aether.
- [Platforms](https://docs.aetherhq.dev/docs/platforms): Supported social media platforms and availability in V1.
- [Instagram](https://docs.aetherhq.dev/docs/platforms/instagram): Instagram publishing, stories, reels, inbox, and comment-to-DM on Aether.
- [LinkedIn](https://docs.aetherhq.dev/docs/platforms/linkedin): LinkedIn OAuth connect, personal profile publishing, and scheduling on Aether.
- [Threads](https://docs.aetherhq.dev/docs/platforms/threads): Threads OAuth connect, publishing, scheduling, and platform overrides on Aether.
- [TikTok](https://docs.aetherhq.dev/docs/platforms/tiktok): TikTok OAuth connect, video and photo publishing, and scheduling on Aether.

## API Reference
- [Health](https://docs.aetherhq.dev/docs/api-reference/health): Check Aether API service health and availability. Returns database and Redis connection status in real-time.
- [Profiles](https://docs.aetherhq.dev/docs/api-reference/profiles): Manage connected social media accounts across Instagram, Facebook, TikTok, LinkedIn, YouTube, Threads, and Reddit via OAuth abstraction.
- [Posts](https://docs.aetherhq.dev/docs/api-reference/posts): Publish and schedule social media posts across 7 platforms. Supports per-platform overrides, media attachments, and timezone-aware scheduling.
- [Inbox](https://docs.aetherhq.dev/docs/api-reference/inbox): Unified inbox for DMs, comments, and mentions across all connected social platforms. Read and reply to messages from a single endpoint.
- [Analytics](https://docs.aetherhq.dev/docs/api-reference/analytics): Query post and account metrics across connected social platforms. Powered by Tinybird for sub-second analytics and normalized schema.
- [Webhooks](https://docs.aetherhq.dev/docs/api-reference/webhooks): Manage webhook endpoints and delivery logs. HMAC-signed events for post.published, post.failed, comment.created, and message.created.
- [Connect Links](https://docs.aetherhq.dev/docs/api-reference/connect-links): Generate magic OAuth connect links for end-user social account connection without exposing your credentials or Aether branding.
- [O Auth](https://docs.aetherhq.dev/docs/api-reference/oauth): OAuth connect flows (Facebook Page selection after multi-Page authorization)
- [A P I Keys](https://docs.aetherhq.dev/docs/api-reference/api-keys): Create, list, and revoke API keys for authenticating with the Aether REST API. Supports scoped keys and per-profile access restrictions.
- [Organizations](https://docs.aetherhq.dev/docs/api-reference/organizations): Manage organizations, team members, roles, and invitations. Organizations are the top-level billing and access control unit in Aether.
- [Media](https://docs.aetherhq.dev/docs/api-reference/media): Upload media files to cloud storage via presigned URLs. Returns a media key for use in post creation across all connected platforms.
- [Queues](https://docs.aetherhq.dev/docs/api-reference/queues): Configure recurring publish slot schedules for an organization. Posts added to a queue are automatically published at the scheduled times.
- [Automations](https://docs.aetherhq.dev/docs/api-reference/automations): Configure comment-to-DM automation rules that trigger private replies when incoming comments match defined keyword patterns.

## Resources
- [MCP Server](https://docs.aetherhq.dev/docs/resources/mcp): Use Aether from Claude Desktop, Cursor, and any MCP-compatible AI client.
- [Node.js SDK](https://docs.aetherhq.dev/docs/resources/sdk): Official Aether client library for Node.js and TypeScript.