# add_email_account (/docs/mcp/tools/add-email-account)

{/* Generated by scripts/sync-mcp-tools.mjs from happierleads-api. Do not edit: change src/routes/mcp/toolDocs.json there, or add content/mcp-notes/add_email_account.mdx. */}

**Connect mailbox** · Changes data

Connect an existing mailbox to a website for sending outreach, using its SMTP (sending) and IMAP (reading replies) settings. Use purchase_outreach_domains instead to buy new domains with ready-made mailboxes. websiteId comes from list_websites. Each new mailbox uses one of the account's mailbox slots (error "You can't create more email accounts" when none are left); connecting an address the website already has updates that mailbox instead. The credentials are not tested by this call. A new mailbox starts at 2 campaign emails a day and ramps to 20 a day over 4 weeks; warmup stays off until you call toggle_warmup. Returns the saved mailbox (its _id is the emailAccountId) without its passwords.

| Connection | Account URL, team member URL or OAuth |
| --- | --- |

## Parameters [#parameters]

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `websiteId` | `string` | Yes | Website id (24 hex characters) from list_websites. |
| `email` | `string` | Yes | The mailbox's from-address, e.g. jane@acme.example. |
| `fullName` | `string` | Yes | Sender name shown on outgoing mail, e.g. Jane Doe. The first word becomes the first name, the rest the last name. |
| `smtpEmail` | `string` | Yes | SMTP login username, usually the same as email. |
| `smtpHost` | `string` | Yes | SMTP server host name, e.g. smtp.example.com. |
| `smtpPort` | `number` | Yes | SMTP port, e.g. 465 (TLS) or 587. |
| `smtpTLS` | `boolean` | No | Use TLS for SMTP. Default true. |
| `imapEmail` | `string` | Yes | IMAP login username, usually the same as email. |
| `imapHost` | `string` | Yes | IMAP server host name, e.g. imap.example.com. |
| `imapPort` | `number` | Yes | IMAP port, usually 993. |
| `imapTLS` | `boolean` | No | Use TLS for IMAP. Default true. |

## Tool definition [#tool-definition]

What your assistant receives from `tools/list`:

```json
{
  "name": "add_email_account",
  "title": "Connect mailbox",
  "annotations": {
    "title": "Connect mailbox",
    "readOnlyHint": false,
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false
  },
  "inputSchema": {
    "type": "object",
    "properties": {
      "websiteId": {
        "type": "string",
        "description": "Website id (24 hex characters) from list_websites."
      },
      "email": {
        "type": "string",
        "description": "The mailbox's from-address, e.g. jane@acme.example."
      },
      "fullName": {
        "type": "string",
        "description": "Sender name shown on outgoing mail, e.g. Jane Doe. The first word becomes the first name, the rest the last name."
      },
      "smtpEmail": {
        "type": "string",
        "description": "SMTP login username, usually the same as email."
      },
      "smtpHost": {
        "type": "string",
        "description": "SMTP server host name, e.g. smtp.example.com."
      },
      "smtpPort": {
        "type": "number",
        "description": "SMTP port, e.g. 465 (TLS) or 587."
      },
      "smtpTLS": {
        "type": "boolean",
        "description": "Use TLS for SMTP. Default true."
      },
      "imapEmail": {
        "type": "string",
        "description": "IMAP login username, usually the same as email."
      },
      "imapHost": {
        "type": "string",
        "description": "IMAP server host name, e.g. imap.example.com."
      },
      "imapPort": {
        "type": "number",
        "description": "IMAP port, usually 993."
      },
      "imapTLS": {
        "type": "boolean",
        "description": "Use TLS for IMAP. Default true."
      }
    },
    "required": [
      "websiteId",
      "email",
      "fullName",
      "smtpHost",
      "smtpPort",
      "smtpEmail",
      "smtpPassword",
      "imapHost",
      "imapPort",
      "imapEmail",
      "imapPassword"
    ]
  }
}
```