Email

Email lets you send, receive, and manage messages in your Microsoft Outlook account directly from the Nappai dashboard. With a few clicks you can read inbox items, move them between folders, delete or reply to messages, and even attach files to new emails—all without leaving the platform.

How it Works

The component talks to Microsoft Outlook through the Microsoft Graph API. When you first set it up, you create a Microsoft Outlook credential in Nappai’s credential manager. This credential stores the client ID, client secret, tenant ID, and the permissions your app needs. Once the credential is selected, the component uses it to authenticate with Azure AD and obtain an access token. Every operation (send, read, move, etc.) then calls the appropriate Graph API endpoint, sending or retrieving the requested data. Attachments are downloaded or uploaded as needed, and the component can even extract text from supported file types when you enable that option.

Operations

This component offers several operations that you can select based on what you need to do. You can only use one operation at a time:

• Get Message: Retrieve one or more emails from a specified folder.
• Get Folders: List all Outlook folders in the account.
• Send Message: Compose and send a new email, optionally with attachments.
• Delete Message: Remove an email from the mailbox.
• Move Message: Transfer an email from one folder to another.
• Mark as Read: Change the read/unread status of an email.
• Reply Message: Send a reply to an existing email.

To use the component, first select the operation you need in the Operations field.

Inputs

Mapping Mode

This component has a special mode called Mapping Mode. When you enable this mode using the toggle switch, an additional input called Mapping Data is activated, and each input field offers you three different ways to provide data:

• Fixed: You type the value directly into the field.
• Mapped: You connect the output of another component to use its result as the value.
• Javascript: You write Javascript code to dynamically calculate the value.

This flexibility allows you to create more dynamic and connected workflows.

Input Fields

The following fields are available to configure this component. Each field may be visible in different operations:

• Operations: Select the action you want to perform.
  Visible in: Get Message, Get Folders, Send Message, Delete Message, Move Message, Mark as Read, Reply Message

• Credential: Choose the Microsoft Outlook credential you created in Nappai’s credential manager.
  Visible in: All operations

• Tool Name: The name of the tool that will be used when this component is connected as a tool.
  Visible in: Get Message, Get Folders, Send Message, Delete Message, Move Message, Mark as Read, Reply Message

• Tool Description: A detailed description of what this tool does.
  Visible in: Get Message, Get Folders, Send Message, Delete Message, Move Message, Mark as Read, Reply Message

• Tools arguments metadata: Defines the arguments metadata for the tools.
  Visible in: Get Message, Get Folders, Send Message, Delete Message, Move Message, Mark as Read, Reply Message

• Subject: Subject line of the email.
  Visible in: Send Message, Reply Message

• Body: Body content of the email.
  Visible in: Send Message, Reply Message

• Receiver: Email address of the recipient.
  Visible in: Send Message

• Attachments: Email attachments (File ID, File URL or File content).
  Visible in: Send Message

• Folder ID: ID of the Outlook folder.
  Visible in: Get Message, Move Message

• Folders: Outlook folders.
  Visible in: Get Message, Move Message

• Message ID: ID of the email message.
  Visible in: Get Message, Delete Message, Move Message, Mark as Read, Reply Message

• Selection Mode: Choose how to select messages for operations that support multiple items.
  Visible in: Get Message, Move Message

• Max Count: Maximum number of emails to retrieve.
  Visible in: Get Message

• Fetch Attachments: 📥 Download attachments found in the emails. If disabled, attachments will be ignored. This is required for processing attachments.
  Visible in: Get Message, Move Message

• Process Attachments: 📄 Requires ‘Fetch Attachments’. If enabled, attempts to extract text content from supported downloaded attachments (e.g., PDF, DOCX). If disabled, attachments are fetched but not processed for text.
  Visible in: Get Message, Move Message

• Mapping Data: Data used when Mapping Mode is enabled.
  Visible in: All operations (only when Mapping Mode is on)

• Mapping Mode: Enable mapping mode to process multiple data records in batch.
  Visible in: Get Message, Get Folders, Send Message, Delete Message, Move Message, Mark as Read, Reply Message

Outputs

• Data: The raw data returned by the selected operation (e.g., email details, folder list).
• Tool: A tool representation that can be used by Nappai’s AI agents.

Usage Example

Example 1 – Get Message

1. Set Operations to Get Message.
2. Enter the Folder ID of the inbox.
3. (Optional) Set Max Count to limit how many emails to fetch.
4. Click Run.
   The component returns a list of email objects that you can feed into other components or use in an AI agent.

Example 2 – Send Message

1. Set Operations to Send Message.
2. Fill in Receiver, Subject, and Body.
3. (Optional) Add attachments by selecting files or providing URLs.
4. Click Run.
   The email is sent from your Outlook account, and the component outputs the sent message’s details.

Related Components

• OutlookEmailComponent – The underlying component that powers this UI.
• FileUploadComponent – Use to upload files that can then be attached to emails.
• DataFilterComponent – Filter email lists before passing them to other actions.

Tips and Best Practices

• Use Mapping Mode when you need to process many emails at once; it saves time and keeps your workflow tidy.
• Enable Process Attachments only if you need to read the content of attachments; it can increase execution time.
• Keep your credential secure—never share the client secret or tenant ID in public scripts.
• Test with a small Max Count first to ensure your filters work before scaling up.
• Use the Tool fields when integrating with AI agents so the agent can understand what the component does.

Security Considerations

• The component relies on a Microsoft Outlook credential stored in Nappai’s credential manager.
• Ensure the credential has the minimum permissions required (e.g., Mail.ReadWrite for sending and reading).
• Do not expose the credential details in logs or shared workflows.
• When using attachments, be cautious of file types that could contain malware; consider adding a virus scan step if your organization requires it.