# Conversations Inbox Messages

> Conversations Inbox & Messages API skill. Use when working with Conversations Inbox & Messages for conversations. Covers 16 endpoints.

- Skill: `lap-platform/conversations-inbox-messages` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add lap-platform/conversations-inbox-messages`
- Raw SKILL.md: https://api.skillmd.com/api/skills/lap-platform/conversations-inbox-messages/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: Lap-Platform (https://skillmd.com/u/lap-platform)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/lap-platform/conversations-inbox-messages

---


# Conversations Inbox & Messages
API version: v3

## Auth
OAuth2 | ApiKey private-app in header

## Base URL
https://api.hubapi.com

## Setup
1. Set your API key in the appropriate header
2. GET /conversations/v3/conversations/channel-accounts -- verify access
3. POST /conversations/v3/conversations/actors/batch/read -- create first read

## Endpoints

16 endpoints across 1 groups. See references/api-spec.lap for full details.

### conversations
| Method | Path | Description |
|--------|------|-------------|
| POST | /conversations/v3/conversations/actors/batch/read | Get a group of actors |
| GET | /conversations/v3/conversations/actors/{actorId} | Get a single actor |
| GET | /conversations/v3/conversations/channel-accounts | Get channel accounts |
| GET | /conversations/v3/conversations/channel-accounts/{channelAccountId} | Get a single channel account |
| GET | /conversations/v3/conversations/channels | Get channels |
| GET | /conversations/v3/conversations/channels/{channelId} | Get a single channel |
| GET | /conversations/v3/conversations/inboxes | Get conversations inboxes |
| GET | /conversations/v3/conversations/inboxes/{inboxId} | Get a single conversations inbox |
| GET | /conversations/v3/conversations/threads | Get threads |
| GET | /conversations/v3/conversations/threads/{threadId} | Get a single thread |
| DELETE | /conversations/v3/conversations/threads/{threadId} | Archives a thread |
| PATCH | /conversations/v3/conversations/threads/{threadId} | Update a thread |
| GET | /conversations/v3/conversations/threads/{threadId}/messages | Get message history for a thread |
| POST | /conversations/v3/conversations/threads/{threadId}/messages | Send a message to a thread |
| GET | /conversations/v3/conversations/threads/{threadId}/messages/{messageId} | Get a single message |
| GET | /conversations/v3/conversations/threads/{threadId}/messages/{messageId}/original-content | Get the original content of a single message |

## Common Questions

Match user requests to endpoints in references/api-spec.lap. Key patterns:
- "Create a read?" -> POST /conversations/v3/conversations/actors/batch/read
- "Get actor details?" -> GET /conversations/v3/conversations/actors/{actorId}
- "List all channel-accounts?" -> GET /conversations/v3/conversations/channel-accounts
- "Get channel-account details?" -> GET /conversations/v3/conversations/channel-accounts/{channelAccountId}
- "List all channels?" -> GET /conversations/v3/conversations/channels
- "Get channel details?" -> GET /conversations/v3/conversations/channels/{channelId}
- "List all inboxes?" -> GET /conversations/v3/conversations/inboxes
- "Get inboxe details?" -> GET /conversations/v3/conversations/inboxes/{inboxId}
- "List all threads?" -> GET /conversations/v3/conversations/threads
- "Get thread details?" -> GET /conversations/v3/conversations/threads/{threadId}
- "Delete a thread?" -> DELETE /conversations/v3/conversations/threads/{threadId}
- "Partially update a thread?" -> PATCH /conversations/v3/conversations/threads/{threadId}
- "List all messages?" -> GET /conversations/v3/conversations/threads/{threadId}/messages
- "Create a message?" -> POST /conversations/v3/conversations/threads/{threadId}/messages
- "Get message details?" -> GET /conversations/v3/conversations/threads/{threadId}/messages/{messageId}
- "List all original-content?" -> GET /conversations/v3/conversations/threads/{threadId}/messages/{messageId}/original-content
- "How to authenticate?" -> See Auth section

## Response Tips
- Check response schemas in references/api-spec.lap for field details
- List endpoints may support pagination; check for limit, offset, or cursor params
- Create/update endpoints typically return the created/updated object

## References
- Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas

> Generated from the official API spec by [LAP](https://lap.sh)