# postzen-dev Inbox API

**Canonical:** https://apis.io/apis/postzen-dev/postzen-dev-inbox-api/  
**Provider:** postzen-dev — https://apis.io/providers/postzen-dev/  
**Base URL:** https://api.postzen.dev  
**Documentation:** https://docs.postzen.dev/api-reference

postzen-dev Inbox API is one of 13 APIs that [postzen-dev](https://apis.io/providers/postzen-dev/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Inbox. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Read and moderate comments on Instagram, Facebook, and Threads posts. Every endpoint takes the connected account as `accountId` and identifies the post either by its PostZen post id or by the platform's own post/media id. Reads also refresh PostZen's stored copy of the thread. An account on any other platform returns `400 platformUnsupported`, and the write endpoints need the account's comment-management scope — reconnect the account when they answer `403 platformCapabilityMissing`. The conversation endpoints cover Instagram direct messages instead: they read PostZen’s synced copy of each thread, refresh it from the platform as a side effect, and keep read state and archive state locally because Meta exposes neither. Sending is bounded by Meta’s 24-hour reply window, which surfaces as `400 PLATFORM_LIMITATION`.

## Operations (12)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/inbox/comments/{postId}` | List comments on a post |
| POST | `/v1/inbox/comments/{postId}` | Comment on a post or reply to a comment |
| DELETE | `/v1/inbox/comments/{postId}` | Delete a comment |
| POST | `/v1/inbox/comments/{postId}/{commentId}/hide` | Hide a comment |
| DELETE | `/v1/inbox/comments/{postId}/{commentId}/hide` | Unhide a comment |
| GET | `/v1/inbox/conversations` | List direct message conversations |
| GET | `/v1/inbox/conversations/search` | Search direct message conversations |
| GET | `/v1/inbox/conversations/{conversationId}` | Get a direct message conversation |
| PUT | `/v1/inbox/conversations/{conversationId}` | Archive or unarchive a conversation |
| POST | `/v1/inbox/conversations/{conversationId}/read` | Mark a conversation read |
| GET | `/v1/inbox/conversations/{conversationId}/messages` | List messages in a conversation |
| POST | `/v1/inbox/conversations/{conversationId}/messages` | Send a direct message |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/postzen-dev/openapi/postzen-dev-inbox-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/postzen-dev/json-schema/postzen-dev-comment-automation-create-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/postzen-dev/json-schema/postzen-dev-contact-schema.json
- **JSONSchema** — https://artifacts.apis.io/postzen-dev/json-schema/postzen-dev-comment-automation-update-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/postzen-dev/json-schema/postzen-dev-contact-create-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/postzen-dev/json-schema/postzen-dev-contact-update-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/postzen-dev/json-schema/postzen-dev-contact-channel-schema.json

## Other postzen-dev APIs (12)

- [postzen-dev Accounts API](https://apis.io/apis/postzen-dev/postzen-dev-accounts-api/)
- [postzen-dev Analytics API](https://apis.io/apis/postzen-dev/postzen-dev-analytics-api/)
- [postzen-dev API Keys API](https://apis.io/apis/postzen-dev/postzen-dev-api-keys-api/)
- [postzen-dev Comment Automations API](https://apis.io/apis/postzen-dev/postzen-dev-comment-automations-api/)
- [postzen-dev Connect API](https://apis.io/apis/postzen-dev/postzen-dev-connect-api/)
- [postzen-dev Contacts API](https://apis.io/apis/postzen-dev/postzen-dev-contacts-api/)
- [postzen-dev Media API](https://apis.io/apis/postzen-dev/postzen-dev-media-api/)
- [postzen-dev Posts API](https://apis.io/apis/postzen-dev/postzen-dev-posts-api/)
- [postzen-dev Profiles API](https://apis.io/apis/postzen-dev/postzen-dev-profiles-api/)
- [postzen-dev Queues API](https://apis.io/apis/postzen-dev/postzen-dev-queues-api/)
- [postzen-dev Webhook Events API](https://apis.io/apis/postzen-dev/postzen-dev-webhook-events-api/)
- [postzen-dev Webhooks API](https://apis.io/apis/postzen-dev/postzen-dev-webhooks-api/)

## Tags

Inbox

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/postzen-dev/postzen-dev-inbox-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/postzen-dev/.