Register Webhook

POST/bots/{bot_id}/callbacks

Add a URL, or add events to a URL already registered.

Scopebots:callbacks · older apps: write:bots

Have the bot POST its events to your HTTPS endpoint. Events: instant_message, chat_message, group_message, group_invite, balance_changed, script_dialog, teleport_status, online_status, offer_inventory, offer_friendship, offer_teleport, offer_friendship_accepted, offer_friendship_declined, start_typing, stop_typing — or "all".

Usage

curl -X POST "https://api.lifebots.cloud/api/v1/bots/$BOT_ID/callbacks" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://yourapp.com/hook",
    "events": "instant_message,group_invite"
  }'

Path parameters

Name	Type	Description
`bot_id`	UUID	The bot's avatar UUID (agentId from GET /bots).

Body (JSON)

Name	Type	Required	Description
`url`	string	yes	Your HTTPS endpoint.
`events`	string	no	Comma-separated events, or "all" (default).

Example response

{
  "success": true,
  "data": {
    "result": "OK"
  },
  "meta": {
    "timestamp": "2026-10-02T12:00:00.000Z",
    "version": "1.0"
  }
}

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