---
title: Send a message - Beeper Developer Docs
---

Deprecated

POST/v0/send-message

- Beeper Desktop API server http\://localhost:23373/v0/send-message

Send a text message to a specific chat. Supports replying to existing messages. Returns the sent message ID. **Use [`POST /v1/chats/{chatID}/messages`](/desktop-api-reference/resources/messages/methods/send/index.md) instead.**

## Request Body

Select media typeapplication/json

object

**chatID**

required

Unique identifier of the chat (a.k.a. room or thread).

string

##### Example

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

**text**

Text content of the message you want to send. You may use markdown.

string

**replyToMessageID**

Provide a message ID to send this as a reply to an existing message

string

## Responses

### 200

Tool executed successfully

Select media typeapplication/json

object

**success**

required

boolean

**error**

string

**chatID**

required

Unique identifier of the chat (a.k.a. room or thread).

string

##### Example

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

**pendingMessageID**

required

Pending message ID

string

##### Example

```
{
  "success": true,
  "chatID": "!signal_adamvy:local-signal.localhost",
  "pendingMessageID": "m1694783291234567"
}
```

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