--- title: Configuring email polling description: In this article we will explain how to configure email poller on the settings page, for creating cases from emails sent to a specified mailbox. --- [Skip to content](https://support.cydarm.com/en/knowledge/configuring-email-polling#main-content) English Show submenu for translations [More support](https://support.cydarm.com/en/knowledge/kb-tickets/new?hsLang=en) [Customer portal](https://support.cydarm.com/tickets-view?hsLang=en) ![Cydarm Logo](https://support.cydarm.com/hs-fs/hubfs/cydarm%202024%20logo%20blue%20on%20transparent%201000x250%20(3).png?width=200&height=50&name=cydarm%202024%20logo%20blue%20on%20transparent%201000x250%20(3).png) Open main navigation Close main navigation - English Show submenu for translations - [More support](https://support.cydarm.com/en/knowledge/kb-tickets/new) - [Customer portal](https://support.cydarm.com/tickets-view) - Contact us Contact us How can we help you? - There are no suggestions because the search field is empty. 1. [Knowledge Base](https://support.cydarm.com/en/knowledge?hsLang=en) 2. [Cydarm Administration](https://support.cydarm.com/en/knowledge/cydarm-administration?hsLang=en) 3. [Integrations](https://support.cydarm.com/en/knowledge/cydarm-administration?hsLang=en#integrations) # Configuring email polling ## In this article, we will explain how to configure the email poller on the settings page to create cases from emails sent to a specified mailbox. ### Overview Email polling relies on accessing a dedicated email inbox using either IMAP or MSGraphAPI protocol. Cydarm's email poller service polls the inbox to look for unread emails. Any unread emails are downloaded and converted into Cydarm cases, then marked as **read** on the server. A user with *integration manager* or *administrator* [role permissions](https://support.cydarm.com/en/knowledge/role-based-access-control?hsLang=en) can configure the email poller from the `Settings` page on the Cydarm UI. Prior to Cydarm version 0.8.37, the email poller was configured using YAML files on your server. If you have pre-existing email pollers configured, these will continue to work along side new ones. However only the new style of email pollers can be inspected via the Cydarm UI. Our recommendation is that you deactivate your older email pollers once you confirm that the new email pollers are working as expected. If you self-host, information on the legacy email poller configuration can be found [here](https://support.cydarm.com/en/knowledge/configuring-email-polling-legacy?hsLang=en). For hosted customers, please log a support ticket.  ### Configuration  1. Navigate to the `Settings > Connectors` page. Connectors is located on the left hand panel of the Settings page. 2. Click the button to ****Create New Connector.**** 3. ****Actuator and Connector Type:**** Select email poller for both fields. 4. **Name** and **Description**: Enter a meaningful name and description for your email poller.  On the next page of the form you will enter the specifics to connect to your IMAP or MSGraphAPI mailbox. ![](https://support.cydarm.com/hs-fs/hubfs/undefined-2.png?width=392&height=263&name=undefined-2.png) #### IMAP instructions For your IMAP mailbox, you need the following fields: | **Type** | IMAP | | --- | --- | | **Server Hostname** | e.g. imap.server.com:993 | | **Username** | Often this is your email address e.g. sample@sample.com | | **Password** | Email account password | | **Mailbox** | Mailbox folder to monitor e.g. Inbox | | **Skip TLS hostname verification** | Leave unchecked except in special circumstances such as the IMAP server uses a self-signed certificate | ![](https://support.cydarm.com/hs-fs/hubfs/image-png-Jan-03-2024-01-08-55-9518-AM.png?width=387&height=498&name=image-png-Jan-03-2024-01-08-55-9518-AM.png) #### MSGraphAPI instructions To complete the configuration of a connector that will poll an email account via MSGraphAPI, you will need the following fields: | **Type** | MSGraphAPI | | --- | --- | | **Server Hostname** | AzureTenantID (UUID) | | **Username** | EntityID: This should be the UUID that serves as the Application ID of the Service Principal for the Enterprise Application that authenticates with the MSGraphAPI. | | **Password** | Client Secret: In Entra ID, locate the Service Principal under App Registrations and generate a new Client Secret. This is the password you will paste into the field. | | **Mailbox** | This should be in the format `UUID:MailboxName`, where UUID is the ObjectID of the user account associated with the target mailbox, and `MailboxName` is the name of the folder you want to monitor (e.g., SOAR). The integration will only load unread emails. For example, if the user ID is `12345678-abcd-1234-edgh-1234567890ab` and the folder name is `NewAlerts`, the format would be `12345678-abcd-1234-edgh-1234567890ab:NewAlerts` | | **Skip TLS hostname verification** | Leave unchecked except in special circumstances | ![](https://support.cydarm.com/hs-fs/hubfs/image-png-Jan-03-2024-01-08-23-0943-AM.png?width=372&height=416&name=image-png-Jan-03-2024-01-08-23-0943-AM.png) #### Set the case defaults In the lower part of the form, set the values that will apply by default to all cases created by this email poller: - ![](https://support.cydarm.com/hs-fs/hubfs/image-png-Jan-03-2024-01-06-42-1074-AM.png?width=382&height=505&name=image-png-Jan-03-2024-01-06-42-1074-AM.png)Organization name - Severity - Tags (optional - one or more tags to apply to every created case) - ACL (if in doubt, use "\ case defaults") Tags can be used to automate functions. For example, if you have a mailbox which receives vulnerability advisories for review, you could tag all cases created with a tag for vulnerabilities. You could then automatically add a vulnerability advisory review playbook via [automated playbook addition](https://support.cydarm.com/en/knowledge/introduction-to-playbooks?hsLang=en#tags). Finally, there is a checkbox to activate the connector. If checked, then the connector will automatically be activated when you submit the form. You can activate and deactivate the connector later from the table view on the `Settings > Connectors` page. #### Check status and test email poller The `Connectors` page will list all available connectors including your new email poller. The status icon at the left will show a tick mark when it is successfully connected. Or a warning symbol if there is an error. The hover text on the warning symbol will describe the connection error to assist you with troubleshooting. To test your email poller, send an email to the specified mailbox using [these instructions.](https://support.cydarm.com/en/knowledge/create-or-post-comments-on-a-case-via-email?hsLang=en) ![](https://support.cydarm.com/hs-fs/hubfs/Screenshot%202024-01-03%20at%2010-04-44%E2%80%AFam-png.png?width=670&height=136&name=Screenshot%202024-01-03%20at%2010-04-44%E2%80%AFam-png.png)   For more detailed technical information please refer to our [Cydarm API documentation.](https://support.cydarm.com/en/knowledge/api-documentation?hsLang=en) - [General](https://support.cydarm.com/en/knowledge/general?hsLang=en#main-content) - [User Guides](https://support.cydarm.com/en/knowledge/general?hsLang=en#user-guides) - [Updates & Release Notes](https://support.cydarm.com/en/knowledge/general?hsLang=en#updates-release-notes) - [Playbooks](https://support.cydarm.com/en/knowledge/general?hsLang=en#playbooks) - [Cydarm Administration](https://support.cydarm.com/en/knowledge/cydarm-administration?hsLang=en#main-content) - [Authentication](https://support.cydarm.com/en/knowledge/cydarm-administration?hsLang=en#authentication) - [Application Administration](https://support.cydarm.com/en/knowledge/cydarm-administration?hsLang=en#application-administration) - [Integrations](https://support.cydarm.com/en/knowledge/cydarm-administration?hsLang=en#integrations) - [API](https://support.cydarm.com/en/knowledge/cydarm-administration?hsLang=en#api) [![Cydarm Logo](https://support.cydarm.com/hs-fs/hubfs/cydarm%202024%20logo%20blue%20on%20transparent%201000x250%20(3).png?width=200&height=50&name=cydarm%202024%20logo%20blue%20on%20transparent%201000x250%20(3).png "Cydarm Logo")](http://cydarm.com) [mailto:email@email.com](mailto:email@email.com) Copyright © 2026, Cydarm Technologies