Api

---
name: conversations-inbox-messages
description: "Conversations Inbox & Messages API skill. Use when working with Conversations Inbox & Messages for conversations. Covers 16 endpoints."
version: 1.0.0
generator: lapsh
---

# 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)