accounts API

The accounts API first appeared in Thunderbird 66.

Permissions

accountsRead

See your mail accounts, their identities and their folders

Note

The permission accountsRead is required to use messenger.accounts.*.

Functions

list([includeFolders])

Returns all mail accounts.

Parameters

[includeFolders]

(boolean, optional)

– [Added in TB 91]

Specifies whether the returned MailAccount objects should included their account’s folders. Defaults to true.

Return type (Promise)

array of MailAccount

Required permissions

  • accountsRead

get(accountId, [includeFolders])

Returns details of the requested account, or null if it doesn’t exist.

Parameters

accountId

(string)

[includeFolders]

(boolean, optional)

– [Added in TB 91]

Specifies whether the returned MailAccount object should included the account’s folders. Defaults to true.

Return type (Promise)

Required permissions

  • accountsRead

getDefault([includeFolders])

– [Added in TB 85, backported to TB 78.7.0]

Returns the default account, or null if it is not defined.

Parameters

[includeFolders]

(boolean, optional)

– [Added in TB 91]

Specifies whether the returned MailAccount object should included the account’s folders. Defaults to true.

Return type (Promise)

Required permissions

  • accountsRead

setDefaultIdentity(accountId, identityId)

– [Added in TB 76]

Sets the default identity for an account.

Parameters

accountId

(string)

identityId

(string)

Required permissions

  • accountsRead

getDefaultIdentity(accountId)

– [Added in TB 85, backported to TB 78.7.0]

Returns the default identity for an account, or null if it is not defined.

Parameters

accountId

(string)

Return type (Promise)

Required permissions

  • accountsRead

Types

MailAccount

An object describing a mail account, as returned for example by the list([includeFolders]) and get(accountId, [includeFolders]) methods. The folders property is only included if requested.

object

id

(string)

A unique identifier for this account.

identities

(array of MailIdentity)

– [Added in TB 76]

The identities associated with this account. The default identity is listed first, others in no particular order.

name

(string)

The human-friendly name of this account.

type

(string)

What sort of account this is, e.g. imap, nntp, or pop3.

[folders]

(array of MailFolder, optional)

The folders for this account are only included if requested.