Inbox API
DMs, comments, and mentions from Instagram, Facebook, LinkedIn, Threads, and Reddit — unified in one normalized API. Build your inbox UI once; it works everywhere.
import Aether from "aether";
const aether = new Aether({ apiKey: process.env.AETHER_API_KEY });
// Fetch unread messages across all connected accounts
const messages = await aether.inbox.list({
status: "unread",
limit: 20,
});
// → [
// { id: "msg_1", platform: "instagram", type: "dm",
// from: { name: "Sarah K." }, text: "Love this!", ... },
// { id: "msg_2", platform: "facebook", type: "comment", ... },
// ]// Reply to a message
await aether.inbox.reply("msg_1", {
text: "Thanks Sarah! Glad you love it 🙏",
});
// Mark as read
await aether.inbox.markRead("msg_1");DMs, mentions, and comment threads from every connected platform in one normalized API response. Build your inbox UI once; it works for all platforms.
Send a reply to any message with a single API call. Platform-specific delivery (DM vs comment reply) is handled automatically based on the message type.
Subscribe to message.created and message.updated events. Aether POSTs to your endpoint the moment a new message arrives — no polling required.
Mark messages as read or unread. Track which messages have been handled. Filter your inbox by read status, platform, or date range.
AI-native
Subscribe to the message.created webhook. Route incoming messages to Claude. Reply via the Inbox API. The Aether MCP server exposes this as a native tool — no glue code required.
The Inbox API covers Direct Messages (DMs), comment threads on your posts, and mentions — depending on what each platform exposes via their API. Instagram DMs and comments, Facebook messages and comments, LinkedIn messages, Reddit DMs and post replies, and Threads replies are all included.
Yes. Instagram Direct Messages are available for Business accounts with messaging permissions enabled. This requires your users to grant the instagram_manage_messages permission during the connect link OAuth flow.
Yes — this is one of the primary use cases. Subscribe to the message.created webhook, route the message to your AI model, and reply via POST /v1/inbox/{id}/reply. The Aether MCP server also supports this workflow natively for Claude-based agents.
Subscribe to the message.created webhook event in the Aether dashboard or via the Webhooks API. Payloads are HMAC-SHA256 signed and delivered within seconds of the message arriving on the platform.
Yes. The list messages endpoint returns a cursor-paginated response. Use the nextCursor field to fetch the next page. Filter by platform, profileId, read status, or date range to narrow results.
Instagram (DMs + comments), Facebook (messages + comments), LinkedIn (messages), Threads (replies), and Reddit (DMs + post replies). YouTube comment threads are covered by the Comments API.
Included in all plans. Free tier available, no credit card required.
Start for free →