Key Methods and Their Uses

• SetConfig: Must be run first to configure mail server settings and access credentials. It supports parameters like username, password, SMTP/IMAP servers and ports, SSL usage, and default credential options. This setup ensures secure and proper connection before other email operations.
• GetMails: Retrieves emails from a specified IMAP folder, allowing filtering by read or unread status. Returns a collection of messages that subsequent methods can process.
• ReadMail: Reads a single email message, providing details such as subject, body, sender, CC, BCC, and attachment count.
• ReplyMail: Sends an automatic reply to a message, with options to reply to all recipients, include BCC, format the body as HTML, and attach files. Attachments are specified by file paths separated by commas.
• SendMail: Sends new email messages with configurable recipients (To, CC, BCC), subject, body (HTML optional), and attachments, similar to ReplyMail. The sender address is configured via SetConfig.
• SaveAllAttachments: Downloads all attachments from a specified email message to a local directory path.
• MarkAsRead / MarkAsUnread: Marks specific messages in an IMAP folder as read or unread based on the provided email object.

Processing Multiple Messages

Since some methods like ReadMail, ReplyMail, and SaveAllAttachments operate on single messages, when working with multiple emails retrieved by GetMails, use looping constructs such as For Each or For Loop to iterate through each message in the collection. This approach ensures each email is processed individually within the automation.

Practical Application for ServiceNow Customers

By leveraging these Email connector methods, you can automate email workflows directly within ServiceNow automations, such as monitoring inboxes, processing customer requests, replying to emails, and managing attachments without manual intervention. Proper initial configuration with SetConfig is crucial for successful communication with your mail servers. The methods provide flexibility to handle common email tasks securely and efficiently, improving your incident, request, or notification handling processes.