# On_contactsAdded

Description

Notification after addings users to an address book

EventHandler<string> On_contactsAdded

Response example

{
    "event": "contactsAdded",
    "contacts": [
        {
            "isEditable" : true,
            "peerId": "user@some.server",
            "peerDn": "user@some.server",
            "status": 0,
            "extStatus": 0,
            "lastOnlineTime": 1690962961,
            "additionalStatus": "at lunch"
        }
    ],
    "method": "event"
}

Response Parameters

Name Description
contacts List of contacts
isEditable The flag indicating if a contact can be edited
peerId TrueConf ID unique user identifier
peerDn User display name
status User status. It can have one of the following values:
• -1 - An incorrect user
• 0 - Offline user
• 1 - Available user
• 2 - Busy user
• 5 - The user is in a group conference and is the owner
extStatus The extended user status, which can take one of the following values:
• -1 - Invalid user
• 0 - Offline user
• 1 - User is offline but was recently active
• 2 - Available user
• 3 - User is available on the phone
• 4 - User is available from the terminal
• 5 - User is available but has set the status to do not disturb
• 6 - User is away
• 7 - Busy user
• 8 - User is busy on the phone
• 9 - User is busy at the terminal
• 10 - A user is in a group conference that they created and that can be joined at request
lastOnlineTime Time in Unix format indicataing when the user was last available. If the user is currently available, then this parameter is equal to 0
additionalStatus Additional user status as a string

See also

Last Updated: 09/12/2025