List mailboxes

Tool ID: email_mailboxes_list

Summary

Lists the email accounts (mailboxes) available to your organization and marks which one is the default — the account used when you say “send an email” without naming a specific mailbox.

When to use it

  • First time with Email tools — Learn which accounts exist before reading or sending.
  • Several accounts — Find the id for “sales”, “gmail”, or similar so later requests can use that mailbox.
  • Unclear which account was used — Confirm the default before sending.

What you need

Requirement Required?
Metraclick connection Yes
Tool enabled for your account Yes
Email credentials Yes

Parameters

This tool has no parameters.

What you get back

Field Meaning
default Id of the mailbox used when you omit an account name
mailboxes List of accounts with id, from_email, from_name, and is_default

Example:

{
  "default": "sales",
  "mailboxes": [
    {
      "id": "sales",
      "from_email": "sales@example.com",
      "from_name": "Sales",
      "is_default": true
    },
    {
      "id": "gmail",
      "from_email": "you@gmail.com",
      "from_name": "You",
      "is_default": false
    }
  ]
}

Example prompts

Which email mailboxes do we have connected, and which one is the default?

List our Metraclick email accounts and their from addresses.

Before we send anything, show me the available mailboxes.

Tips

  • Omit the mailbox later — For other email tools, not naming an account uses the default. Only name one when you need a non-default account (“use the gmail mailbox”).
  • Ask your admin — If the list is empty or wrong, email credentials need to be configured for your tenant.

Related