---
title: Create a chat - Beeper Developer Docs
---

Deprecated

POST/v0/create-chat

- Beeper Desktop API server http\://localhost:23373/v0/create-chat

Create a single or group chat on a specific account using participant IDs and optional title. **Use [`POST /v1/chats`](/desktop-api-reference/resources/chats/methods/create/index.md) instead.**

## Request Body

Select media typeapplication/json

object

**accountID**

required

Account to create the chat on.

string

**type**

required

Chat type to create: ‘single’ requires exactly one participantID; ‘group’ supports multiple participants and optional title.

string

Allowed values: single group

**participantIDs**

required

User IDs to include in the new chat.

Array\<string>

\>= 1 items

**title**

Optional title for group chats; ignored for single chats on most platforms.

string

**messageText**

Optional first message content if the platform requires it to create the chat.

string

## Responses

### 200

Tool executed successfully

Select media typeapplication/json

object

**success**

required

boolean

**error**

string

**chatID**

Newly created chat if available.

string

##### Example

```
!NCdzlIaMjZUmvmvyHU:beeper.com
```

### 400

Invalid request parameters

Select media typeapplication/json

object

**error**

required

Error message

string

**code**

Error code

string

**details**

Additional error details

object

***key***

additional properties

string

### 401

Access token is missing or invalid

Select media typeapplication/json

object

**error**

required

Error message

string

**code**

Error code

string

**details**

Additional error details

object

***key***

additional properties

string

### 403

Access token does not have the required scope

Select media typeapplication/json

object

**error**

required

Error message

string

**code**

Error code

string

**details**

Additional error details

object

***key***

additional properties

string

### 404

Resource not found

Select media typeapplication/json

object

**error**

required

Error message

string

**code**

Error code

string

**details**

Additional error details

object

***key***

additional properties

string

### 422

Unprocessable entity - validation error

Select media typeapplication/json

object

**error**

required

Error message

string

**code**

Error code

string

**details**

Additional error details

object

***key***

additional properties

string

### 429

Too many requests - rate limit exceeded

Select media typeapplication/json

object

**error**

required

Error message

string

**code**

Error code

string

**details**

Additional error details

object

***key***

additional properties

string

### 500

Internal server error

Select media typeapplication/json

object

**error**

required

Error message

string

**code**

Error code

string

**details**

Additional error details

object

***key***

additional properties

string