API Reference › Bots — Webhooks
Get Webhook
GET
/bots/{bot_id}/callbacks/{callback_id}One webhook by id.
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 "https://api.lifebots.cloud/api/v1/bots/$BOT_ID/callbacks/$CALLBACK_ID" \
-H "Authorization: Bearer $ACCESS_TOKEN"Path parameters
| Name | Type | Description |
|---|---|---|
bot_id | UUID | The bot's avatar UUID (agentId from GET /bots). |
callback_id | UUID | Callback id returned by List or Register. |
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.