API Reference

Messages

Send a message

post/v1/chats/{chatID}/messages

Send a text message to a specific chat. Supports replying to existing messages. Returns the sent message ID.

Path ParametersExpand Collapse

chatID: string

Unique identifier of the chat.

Body ParametersExpand Collapse

replyToMessageID: optional string

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

text: optional string

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

ReturnsExpand Collapse

chatID: string

Unique identifier of the chat.

pendingMessageID: string

Pending message ID

Send a message

HTTP

HTTP

TypeScript

Python

Go

curl http://localhost:23373/v1/chats/$CHAT_ID/messages \
    -X POST \
    -H "Authorization: Bearer $BEEPER_ACCESS_TOKEN"

200 example

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

Returns Examples

200 example

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