Email source

Email source

The Email source brings email into Outrun so your workflows and agents can act on it. This page explains the two ways to connect mail, forwarding and IMAP sync, and what Outrun does with the messages it receives.

Connection methods

Method How it works Best when
Forwarding Your mail provider forwards a copy of incoming mail to an address for the source. You can create a forwarding rule and prefer not to share mailbox credentials.
IMAP sync Outrun connects to your mailbox and imports new mail from the Inbox and Sent folders. Your provider blocks forwarding, or you want your sent mail in Outrun as well.

You can turn on both methods for the same source. A message that arrives through both is stored once.

Create an Email source

  1. In Outrun, go to Sources, select Add Source, then select Connect on the Email card.
  2. Enter a Source Name and select Create Source.
  3. On 2. Connect your mailbox, choose the Forwarding tab or the IMAP sync tab and follow the steps below.
  4. Select Done.

Set up forwarding

After you create the source, the Forwarding tab shows Your forwarding address. It has this form:

<source-id>@inbound.getoutrun.com

Each Email source has its own address, so you can create several sources with different addresses.

  1. Copy the forwarding address with Copy.
  2. Under Mail provider, choose Gmail, Outlook, iCloud or Other. The app shows the forwarding steps for that provider.
  3. In your mail provider, add the forwarding address and turn forwarding on.

Gmail forwarding confirmation

Gmail sends a confirmation email to a new forwarding address before it forwards anything. Outrun catches that email for you. On the Forwarding tab, the app shows Confirmation email received, a Confirm Gmail Forwarding → link and the confirmation code. Open the link, or enter the code in Gmail, then select Forward a copy of incoming mail to in Gmail settings and save.

Send copies of your own mail

To give Outrun your outgoing mail as well, use the Outbound BCC Training section. It shows Your sent copy address, which has this form:

<source-id>[email protected]

Add this address as a BCC on your outgoing mail, or create a rule that sends copies of your sent mail to it. The app shows steps for each provider. Mail sent to this address is stored as your own sent mail and does not start workflows.

If forwarding is blocked

Some organisations block forwarding to external addresses. If your forwarded mail bounces or never arrives, ask your IT administrator to allow forwarding to inbound.getoutrun.com, or use IMAP sync instead.

Set up IMAP sync

  1. Open the IMAP sync tab.

  2. Under Mail provider, choose Gmail, iCloud, Microsoft 365, Exchange (on-prem) or Other.

  3. Check Host and Port. Outrun fills them in for some providers:

    Provider Host Port
    Gmail imap.gmail.com 993
    iCloud imap.mail.me.com 993
    Microsoft 365 outlook.office365.com 993
    Exchange (on-prem), Other Ask your IT team 993
  4. Enter your Username and an App password from your mail provider. For Microsoft 365, sign in to a Microsoft account instead (see below).

  5. Under How far back should we sync?, choose 1 month ago, 3 months ago (the default), 6 months ago, 1 year ago, a custom date, or Everything (not recommended).

  6. Select Save & begin sync.

Outrun tests the connection before it saves. If the test fails, you see "Connection failed — verify your details are correct" and nothing is saved. Use the Email sync toggle to pause and resume syncing.

iCloud usernames

For iCloud, enter only the part of your iCloud address before the @ as the username, for example janedoe, not [email protected].

Microsoft 365

Microsoft 365 mailboxes connect by signing in, not with a password.

  1. Under Microsoft account, select Add Another Account and sign in to Microsoft.
  2. Select the account to use. Host, port and username are filled in for you.
  3. Choose how far back to sync and save.

Some organisations require an administrator to approve Outrun first. Select Some organizations require IT admin approval first to copy a ready-to-send message with an approval link for your IT administrator. After they approve it, connect your mailbox yourself. To connect the mailbox of someone who has no Outrun account, select Send a connect link instead.

Sync behaviour

  • Forwarding: Outrun processes mail as your provider forwards it.
  • IMAP sync: Outrun checks each connected mailbox every 5 minutes and imports new mail from the Inbox and the Sent folder.
  • Import start date: You cannot change how far back to sync after syncing starts.
  • Old mail: Imported Inbox mail older than 48 hours is stored but does not start workflows, so importing history does not trigger your agents.
  • Sent mail: Mail from your Sent folder or your sent copy address is stored as sent mail and does not start workflows.

What Outrun stores

  • New inbound mail is stored and starts the email workflows connected to the source.
  • A message that reaches the same source more than once, for example through both forwarding and IMAP sync, is stored once.
  • Automatic replies, such as out-of-office messages, are ignored.
  • Attachments are not stored.

Troubleshooting

Forwarded mail bounces or never arrives. See if forwarding is blocked.

The Gmail confirmation never appears. Check that you pasted the forwarding address exactly as shown, including the source ID.

IMAP sync will not save. Check the host, port, username and app password, then save again.

Old mail did not trigger my agent. This is expected. Imported mail older than 48 hours does not start workflows.