---
title: "Open a conversation with someone"
method: POST
path: "/v1/conversations"
tags: ["Messages"]
---

# Open a conversation with someone

`POST /v1/conversations`

## Request

- Base URL: `https://api.postlake.dev`
- URL: `https://api.postlake.dev/v1/conversations`
- Auth: `bearerAuth` (a scheme the document does not define)

Finds or starts the thread with a handle, so a first message does not need an id that does not exist yet. Sends nothing.

## Request body

- object
  - `account` string, required
  - `handle` string, required: e.g. alice.bsky.social

## Response `200`

The conversation

- Conversation: A direct-message thread. inboxAccount names the connected profile receiving messages and sending replies, so callers never infer it from account.
  - `id` string
  - `platform` string
  - `account` string
  - `inboxAccount` InboxAccountIdentity: The connected profile that receives this conversation and sends its replies.
    - `id` string, required
    - `handle` string, required
    - `displayName` string, nullable, required
    - `avatarUrl` string, nullable, required
  - `participants` SocialActor[]
    - `handle` string
    - `displayName` string, nullable
    - `avatarUrl` string, nullable
    - `id` string, nullable: The network's own id, for follow/block/mute
  - `lastMessage` object, nullable
    - `text` string
    - `createdAt` string, date-time
    - `fromMe` boolean
    - `content` MessageContent: A meaningful non-text direct-message payload. This is present for attachments, shared media, and message types the network does not expose in readable form. Do not treat an empty text field with this object as an empty message.
      - `kind` 'attachment' | 'shared_media' | 'unsupported', required
      - `label` string, required
      - `url` string, uri, nullable, required: Provider URL when available. Null means the provider withheld a destination.
  - `unreadCount` integer

---

[API](https://skmtc.dev/postlake/apis/postlake-api.md) · [All operations](https://skmtc.dev/postlake/apis/postlake-api/llms.txt) · [OpenAPI document](https://skmtc.dev/postlake/apis/postlake-api/revisions/f81060e31f69?raw)