Send Group Chat

POST/groups/{group_id}/im

Post in the group chat.

Groups the user registered on LifeBots — on their own bot or a SharedBot — acted on through the bot that runs each group. Commands fail with GROUP_NOT_ACTIVE unless the group's status is running. For any group the user's own bot is in, registered or not, use Bots — Group Moderation.

Usage

curl -X POST "https://api.lifebots.cloud/api/v1/groups/$GROUP_ID/im" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Hello group!"
  }'

Path parameters

Name	Type	Description
`group_id`	UUID	Group UUID.

Body (JSON)

Name	Type	Required	Description
`message`	string	yes	Message text.

Example response

{
  "success": true,
  "data": {
    "result": "OK",
    "groupUUID": "a1b2c3d4-0000-4000-8000-000000000001",
    "action": "send_group_im"
  },
  "meta": {
    "timestamp": "2026-10-02T12:00:00.000Z",
    "version": "1.0"
  }
}

Right after the bot logs in this can answer result "FAIL" with "Bot is still joining group chat sessions" — retry shortly.

Always check success; for commands the bot carries out, also check data.result. See Responses & errors.