group_invite

Name: LifeBots
Rating: 4.8 (150 reviews)

Also accepted as invite

Invite an avatar to a group

Usage

curl -X POST "https://api.lifebots.cloud/api/bot.html" \
  -H "Content-Type: application/json" \
  -d '{
  "action": "group_invite",
  "apikey": "YOUR_API_KEY",
  "botname": "Joe Resident",
  "secret": "bot-secret-123",
  "groupuuid": "b3f87fed-0470-4a7e-b035-100000000000",
  "avatar": "a2e76fcd-9360-4f6d-a924-000000000000",
  "roleuuid": "c4e98afe-1581-4b8f-a146-200000000000",
  "dataType": "json"
}'

Every request also needs apikey, botname and secret — see Authentication.

Parameters

Name	Required	Description
`groupuuid` UUID	yes	Group UUID, or the exact name of a group the bot is in. Also accepted as: `group,` `groupId,` `groupName`
`avatar` UUID	yes	Avatar UUID. Also accepted as: `target`
`roleuuid` UUID	no	Role to invite into. Leave out for Everyone. Also accepted as: `roleId`
`check_membership` flag	no	1 to ONLY check whether the avatar is already a member. No invite is sent.
`nosafehub` flag	no	Send 1 to refuse the command while the bot is in a Safe Hub region.

Example response

{
  "success": true,
  "result": "OK",
  "resulttext": "Group invite sent"
}

With dataType=json. A failure has result: "FAIL" and the reason in resulttext — see Responses & errors.

Good to know

Each avatar can be invited to the same group once every 5 minutes. A repeat fails "Invite on cooldown. Ns remaining."
check_membership=1 turns the call into a membership check — resulttext says whether they are a member, and nothing is sent.
The bot needs the Invite power in the group. Without it, Second Life ignores the invite and the call still answers OK.