Account objects store off of the information that is used for making a Connection to a remote service. Mission Control can be used to establish connections for valid accounts.

Account objects have object paths of the form /org/freedesktop/Telepathy/Account/cm/proto/acct where cm is the Connection Manager name (e.g. gabble, salut) and proto is the protocol name (as used in the object path of a Connection). Account objects implement the interface org.freedesktop.Telepathy.Account.

Settings for an account are managed through D-Bus properties. To reduce D-Bus roundtrips: bulk read the properties with the standard org.freedesktop.DBus.Properties.GetAll method; bulk set properties with the org.freedesktop.Telepathy.Account.UpdateParameters method. Table 3-1 shows the properties of an Account object.

Obtaining connections and managing the online/offline status of accounts is documented in Section 5.2.1 ― From the Account Manager.

Table 3-1Account Properties
Read/Write Properties
Property Type Description Example
DisplayName String The user-visible name of this account. This is how the account is referred to in the user interface, and should be able to be set by the user. Jabber (, Work
Icon String The name of an icon in the system's icon theme or the empty string to not specify an icon (in which case one may be automatically chosen). im-msn
Enabled Boolean Whether or not an account is enabled (whether or not it can be used to go online). N.B. this is different from whether or not it is Valid. True
Nickname String The nickname to set on this account for display to other contacts, as set by the user. Bob McBadgers
AutomaticPresence SimplePresence The presence status that this account should have if it is brought online.
ConnectAutomatically Boolean Whether or not the Account Manager should automatically establish a Connection for this account. True
RequestedPresence SimplePresence The requested presence for this account.
Read-Only Properties
Property Type Description Example
Interfaces DBus_Interface[] A list of the extra interfaces provided by this account. org.freedesktop.Telepathy.Account.Interface.Avatar
Valid Boolean Whether this account is considered by the Account Manager to be complete and usable. True
Parameters Map A map from connection manager parameter names (as in the ConnectionManager interface) to their values.
Connection Connection Either the object path of the Connection to this account, or the special value '/' if there is no connection. /org/freedesktop/Telepathy/Connection/gabble/jabber/bob_40example_2ecom_2fwork
ConnectionStatus integer If the Connection property is non-empty, the status of that connection.
ConnectionStatusReason integer The reason for the last change to ConnectionStatus.
CurrentPresence SimplePresence The actual presence of the account.
NormalizedName String The normalized user ID of the local user on this account.