> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nylon.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Inbox

> Read and reply to direct messages and comments through one resource.

<div className="pillar-hero" data-pillar="inbox">
  <span className="pillar-hero__mark">
    <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="1.8" strokeLinecap="round" strokeLinejoin="round">
      <path d="M4 5h16v11H9l-4 4v-4H4V5Zm4 4h8m-8 3h5" />
    </svg>
  </span>

  <div className="pillar-hero__body">
    <span className="pillar-hero__eyebrow">Pillar 2 of 3</span>
    <p>Direct messages and comments arrive on a single message resource with one shape, and replies go back out through the same call.</p>
    <span className="pillar-status pillar-status--partial">Live on Facebook and Instagram</span>
  </div>
</div>

## Coverage today

The inbox currently covers **Facebook** and **Instagram**. Support for the remaining networks is in build behind the same resource, so adding them will not change the shape of your code.

<Warning>
  Do not build against the inbox for a network that is not listed above. Publishing is available on every network; the inbox is not.
</Warning>

## The model

<CardGroup cols={2}>
  <Card title="One message shape" icon="layers">
    A Facebook direct message and an Instagram comment arrive as the same object, with the same author, thread and timestamp fields.
  </Card>

  <Card title="Reply through the same resource" icon="reply">
    Replies are posted back into a thread with one call. Threading and per-network reply rules are applied for you.
  </Card>

  <Card title="Read state per thread" icon="check-check">
    Unread state is tracked per conversation, so two agents working the same queue never answer the same message twice.
  </Card>

  <Card title="Author identity" icon="user">
    The sender is resolved to a stable identifier where the network provides one, so repeat conversations can be linked.
  </Card>
</CardGroup>

## Message kinds

| Kind           | Facebook | Instagram |
| -------------- | -------- | --------- |
| Direct message | Yes      | Yes       |
| Comment        | Yes      | Yes       |

<Note>
  Endpoint reference for the inbox is not in these docs yet. The only endpoint currently documented and playground-backed is [`GET /v1/profiles`](/api-reference/list-profiles).
</Note>