Installation

The package is available at nuget.org and it can be installed via package manager console by executing following command:

PM> NuGet\Install-Package Aspose.Email-Cloud

Manage Emails in Cloud via .NET REST SDK

Aspose.Email Cloud SDK for .NET is a powerful REST API solution for developers looking to build email management applications in the cloud. This SDK supports various popular file formats, including MSG, EML, VCard, and iCalendar. Developers can create, convert, and manage email messages, calendars, and contacts with ease. Advanced features such as business card recognition, email threading, and server configuration discovery streamline communication workflows.

The SDK enables business card parsing, detecting gender by name, formatting and expanding names, and extracting names from emails. With built-in support for SMTP, POP3, IMAP, and WebDav, the SDK allows seamless integration with cloud storage for email management. The ability to work with email, calendar, and contact files, convert between formats, and manage attachments ensures a complete solution for cloud-based email applications.

Business Cards Recognition

Parse Business Card Image to VCard

Convert captured business card images into vCard format for easy contact management.

Image Located on Storage

Recognize vCard data from business card images stored on cloud storage using the API’s AI-powered recognition.

Email Name API

Detect Gender by Name

Identify a person’s gender based on their name.

Compare Names for Similarity

Compare two names to determine if they belong to the same individual, based on a similarity score.

Format Name

Apply a defined format to standardize a person’s name.

Expand Name

Generate a list of possible name alternatives from a given input.

Parse Name from Email

Extract a person’s name from their email address.

Email Message Files

Supported File Types

Work with EML, MSG, MHTML, and HTML formats.

Create Email File

Create email objects and save them to cloud storage.

Convert Email Formats

Convert between supported formats such as EML to MSG, or MSG to MHTML.

EmailDto Object

Manage comprehensive email data like sender, recipient, body, attachments, and more, using EmailDto.

Append Email to IMAP Folder

Append email messages to specified IMAP folders on cloud storage.

Email Client Features

Built-in Email Client

Manage emails using the built-in client that supports SMTP, POP3, IMAP, EWS, and WebDav.

Search Emails

Search for emails by criteria such as subject or sender.

Fetch Email by ID

Retrieve a specific email by its unique identifier.

Mark Message

Update the read status of emails.

Send Emails

Send new or appended emails using the built-in client.

Email iCalendar API

Work with Calendar Files

Create, edit, and manage ICS files on cloud storage.

Convert Calendar Files

Convert calendar files to other formats, such as AlternateView for email attachments.

Manage Appointments

Add and modify appointments within iCalendar files.

Email vCard API

Create and Edit VCard Files

Create and manage contact information in VCF format.

Upload VCard Files

Upload and download VCard files to and from cloud storage.

AI Business Card Recognition

Automatically parse business card images into VCard files for contact storage.

Email Configuration Features

Discover Server Configurations

Automatically discover mail server settings for common protocols like IMAP, POP3, and SMTP.

Set Up Email Accounts

Configure email accounts for use with the API using discovered settings.

Email Client Threads

Message Threads

Group related emails into threads to organize communication in a structured format.

Fetch Thread Messages

Retrieve all messages within a thread.

Mark All as Read/Unread

Update the status of all messages in a thread.

Delete Thread

Delete an entire thread from the mailbox.

Convert Email, Calendar, and Contact Files

Convert Email Files

Convert between email formats (e.g., EML to MSG, MSG to HTML).

Convert Calendar Files

Convert iCalendar files to other supported formats.

Convert Contact Files

Convert VCard files (VCF) to other formats such as MSG or CSV.

MAPI Message Files API

Create and Edit MSG Files

Manage MSG files that store email, calendar, or contact information.

Add/Edit Attachments

Work with attachments in MAPI email files.

Read and Update Properties

Access and update MAPI properties like subject, sender, and recipient information.

Supported File Formats

Installation

1. Install SDK

Use Package Manager

PM> Install-Package Aspose.Email-Cloud

Use .NET CLI

dotnet add package Aspose.Email-Cloud

2. Get Client Secret and Client ID

• Visit the Aspose.Cloud Dashboard, sign in, and obtain your Client Secret and Client ID.

These are required to authenticate and access the API.

3. Set Up the EmailCloud Object

• Initialize the EmailCloud object with your Client Secret and Client ID:

   using Aspose.Email.Cloud.Sdk.Api;
   var clientSecret = "Your Client Secret";
   var clientId = "Your Client ID";
   var api = new EmailCloud(clientSecret, clientId);
  

4. Check Everything Works

• Test the setup by converting an EML file to MSG format:

   using(var emlStream = File.OpenRead("email.eml"))
   {
       var result = api.Email.ConvertAsync(new EmailConvertRequest("Eml", "Msg", emlStream));
   }
  

Retrieve and Convert Email to MHTML

Learn how to retrieve an email from storage and convert it into MHTML format using Aspose.Email Cloud API for .NET. This example demonstrates seamless email conversion.

// Initialize the EmailGetRequest to retrieve email from storage
var request = new EmailGetRequest
{ 
    Format = "Eml",  // Specify the email format to retrieve
    FileName = "email.eml",  // Name of the email file in storage
    Folder = "folder/on/storage",  // Path to the folder in storage
    Storage = "First Storage"  // Name of the storage
};

// Call the API to retrieve the email document
var result = await api.Email.GetAsync(request);

// Initialize the EmailConvertRequest to convert the email to MHTML format
var convertRequest = new EmailConvertRequest
{ 
    FromFormat = "Eml",  // Source format of the email
    ToFormat = "Mhtml",  // Desired format for conversion
    File = new MemoryStream(File.ReadAllBytes("/path/to/email.eml"))  // Load the email file to convert
};

// Call the API to convert the email to MHTML
var convertedResult = await api.Email.ConvertAsync(convertRequest);

Save MAPI Calendar to MSG Format in Storage

Learn how to save a MAPI Calendar in MSG format to cloud storage using Aspose.Email Cloud API for .NET. Streamline your email calendar operations efficiently.

// Initialize MapiCalendarSaveRequest to save MAPI calendar to storage
var mapiCalendarSaveRequest = new MapiCalendarSaveRequest
{
    Format = "Msg",  // Specify the format of the calendar to be saved (Msg)
    StorageFile = new StorageFileLocation
    {
        FileName = "calendar.msg",  // File name for the calendar
        Storage = "First Storage",  // Storage location
        FolderPath = "file/location/folder/on/storage"  // Path in storage
    },
    Value = new MapiCalendarDto
    {
        // Define calendar attendees
        Attendees = new MapiCalendarAttendeesDto
        {
            AppointmentRecipients = new List<MapiRecipientDto>
            {
                new MapiRecipientDto
                {
                    EmailAddress = "organizer@aspose.com",  // Organizer's email
                    AddressType = "SMTP",
                    DisplayName = "Organizer Name",
                    RecipientType = "MapiTo"
                },
                new MapiRecipientDto
                {
                    EmailAddress = "attendee@aspose.com",  // Attendee's email
                    AddressType = "SMTP",
                    DisplayName = "Attendee Name",
                    RecipientType = "MapiTo"
                }
            }
        },
        // Define other calendar details
        BusyStatus = "Tentative",
        StartDate = DateTime.Today,
        EndDate = DateTime.Today.AddDays(1),
        Subject = "Some summary",
        Location = "Some location"
    }
};

// Call the API to save the MAPI calendar to storage
await api.MapiCalendar.SaveAsync(mapiCalendarSaveRequest);

Convert Contact from MSG to VCard Format

Convert contact details from MSG format to VCard format effortlessly using Aspose.Email Cloud API for .NET. Simplify contact conversions for .NET developers.

// Initialize ContactConvertRequest to convert a contact from MSG to VCard format
var contactConvertRequest = new ContactConvertRequest
{
    FromFormat = "Msg",  // Source format of the contact
    ToFormat = "VCard",  // Desired format for conversion
    File = new MemoryStream(File.ReadAllBytes("/path/to/contact.msg"))  // Load the MSG contact file to convert
};

// Call the API to convert the contact to VCard format
var result = await api.Contact.ConvertAsync(contactConvertRequest);