IMAP

Monitor folders in an IMAP mailbox for new emails. This article explains how to set up the IMAP integration using either Gmail or Microsoft 365 (Outlook).

Gmail

If you want to set up a Gmail account for the IMAP integration in Torq, you'll need to provide a username and password. The username is the email address of the account, but the password is not the regular account password. You'll need to create an app password for that account. To learn how to create an app password, see here.

Create an IMAP integration

1. Go to Integrations > Triggers, and locate the IMAP card.
2. Configure the IMAP integration and click Add.
   1. Integration name: a meaningful name for the integration. For our example, we use outlook_imap.
   2. Server: outlook.office365.com:993.
   3. User: The email address of the account to be monitored.
   4. Password: The password for the email address.
   5. Interval: The monitoring interval for incoming emails. It can be entered in minutes, hours, or days. For example, 1m for 1 minute, 2h for 2 hours, and 1d for 1 day.
   6. Folder: You can use the shaded default, INBOX. The folder name is case-blind, so INBOX and Inbox are the same.

Here is the outcome for our example:

The IMAP integrations list is displayed:

3. Click the top right x to return to Integrations.

Using the IMAP integration

To validate the integration, we create a triggered workflow:

1. Open Create a Workflow and enter a name, for example imap_test_outlook_365, select Integrations.
   
2. Click Pick Integration. The following window is displayed:
   
   
   
3. Click IMAP. In the displayed window, choose the outlook_imap integration we just created.
   
   
   
4. Click the IMAP (Envelope) icon.
   
   
   
5. Open another browser tab and from a local mail account, send an email to the monitored Outlook account.
6. Wait for at least one wait interval (one minute here).
7. Open the Event log to view the event JSON that triggered the workflow. Click the  icon to see the full JSON output.