Send

API Reference

Messages

Send a message

post/v0/send-message

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

Body ParametersExpand Collapse

chatID: string

The identifier of the chat where the message will send (accepts both chatID and local chat ID)

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

messageID: string

Stable message ID.

HTTPTypeScript

curl http://localhost:23373/v0/send-message \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $BEEPER_ACCESS_TOKEN" \
    -d '{
          "chatID": "!NCdzlIaMjZUmvmvyHU:beeper.com"
        }'

200 example

{
  "success": true,
  "error": "error",
  "messageID": "m1694783291234567"
}

Returns Examples

200 example

{
  "success": true,
  "error": "error",
  "messageID": "m1694783291234567"
}