> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pinkfish.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# email

> Send emails with HTML/text content and attachments

**Server path:** `/email` | **Type:** Embedded | **PCID required:** No

## Tools

| Tool                        | Description                                                                                                                                                                                                           |
| --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [`email_send`](#email_send) | Send an email via the integrated email service. Supports HTML and plain text content, multiple recipients, CC, BCC, attachments via URL, and reply threading. Either htmlBody or textBody (or both) must be provided. |

***

## email\_send

Send an email via the integrated email service. Supports HTML and plain text content, multiple recipients, CC, BCC, attachments via URL, and reply threading. Either htmlBody or textBody (or both) must be provided.

**Parameters:**

| Parameter        | Type      | Required | Default | Description                                                                                                                                                                                                                 |
| ---------------- | --------- | -------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `to`             | string    | Yes      | —       | Recipient email address(es). Single email string or array. Example: "[john@example.com](mailto:john@example.com)" or \["[john@example.com](mailto:john@example.com)", "[jane@example.com](mailto:jane@example.com)"]        |
| `subject`        | string    | Yes      | —       | Email subject line. Required for email delivery                                                                                                                                                                             |
| `htmlBody`       | string    | No       | —       | HTML formatted email content. Example: "\<p>Hello \<b>World\</b>\</p>". Either htmlBody or textBody (or both) must be provided. If only textBody is provided, htmlBody will be auto-generated                               |
| `textBody`       | string    | No       | —       | Plain text email content. Either htmlBody or textBody (or both) must be provided. If only htmlBody is provided, textBody will be auto-generated by stripping HTML tags                                                      |
| `replyTo`        | string    | No       | —       | Reply-to email address (where replies go). Example: "[support@example.com](mailto:support@example.com)"                                                                                                                     |
| `cc`             | string    | No       | —       | CC recipient(s). Example: "[manager@example.com](mailto:manager@example.com)" or \["[manager@example.com](mailto:manager@example.com)", "[team@example.com](mailto:team@example.com)"]                                      |
| `bcc`            | string    | No       | —       | BCC recipient(s) - hidden from other recipients. Example: "[archive@example.com](mailto:archive@example.com)"                                                                                                               |
| `threadId`       | string    | No       | —       | Email thread ID to add this email to an existing conversation                                                                                                                                                               |
| `attachmentUrls` | string\[] | No       | —       | URLs of files to attach. Files will be fetched and attached automatically. Example: \["[https://example.com/report.pdf](https://example.com/report.pdf)", "[https://example.com/image.png](https://example.com/image.png)"] |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "to": {
        "oneOf": [
          {
            "type": "string"
          },
          {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        ],
        "description": "Recipient email address(es). Single email string or array. Example: \"john@example.com\" or [\"john@example.com\", \"jane@example.com\"]"
      },
      "subject": {
        "type": "string",
        "description": "Email subject line. Required for email delivery"
      },
      "htmlBody": {
        "type": "string",
        "description": "HTML formatted email content. Example: \"<p>Hello <b>World</b></p>\". Either htmlBody or textBody (or both) must be provided. If only textBody is provided, htmlBody will be auto-generated"
      },
      "textBody": {
        "type": "string",
        "description": "Plain text email content. Either htmlBody or textBody (or both) must be provided. If only htmlBody is provided, textBody will be auto-generated by stripping HTML tags"
      },
      "replyTo": {
        "type": "string",
        "description": "Reply-to email address (where replies go). Example: \"support@example.com\""
      },
      "cc": {
        "oneOf": [
          {
            "type": "string"
          },
          {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        ],
        "description": "CC recipient(s). Example: \"manager@example.com\" or [\"manager@example.com\", \"team@example.com\"]"
      },
      "bcc": {
        "oneOf": [
          {
            "type": "string"
          },
          {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        ],
        "description": "BCC recipient(s) - hidden from other recipients. Example: \"archive@example.com\""
      },
      "threadId": {
        "type": "string",
        "description": "Email thread ID to add this email to an existing conversation"
      },
      "attachmentUrls": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "URLs of files to attach. Files will be fetched and attached automatically. Example: [\"https://example.com/report.pdf\", \"https://example.com/image.png\"]"
      }
    },
    "required": [
      "to",
      "subject"
    ]
  }
  ```
</Expandable>