Other email (IMAP)

Email List

List recent emails from one connected mailbox folder (Gmail/Outlook).

1 creditRuns in your Other email (IMAP) account

Endpoint

Parameters

NameTypeRequiredNote
rolestring · optionalstringoptional

Read-status filter: all (default), seen (read only), unseen (unread only).

One of: all, seen, unseen

limitnumber · optionalnumberoptional

Max results (default 20, maximum 50).

Default: 20

sincestring · optionalstringoptional

Only emails dated at or after this ISO date or date-time, e.g. "2026-09-22" or "2026-09-22T00:00:00Z". Use it for "in the last N days" / "since Monday" questions instead of filtering the newest page yourself.

untilstring · optionalstringoptional

Only emails dated before this ISO date or date-time (exclusive).

cursorstring · optionalstringoptional

The `cursor` of the previous result, when its `more` was true. Pass it with the same accountId, folder and since / until to read the next page; repeat until `more` is false.

folderstring · optionalstringoptional

Folder to read: INBOX (the default when omitted), SENT, DRAFTS, TRASH or SPAM, or ALL to list every folder together, sent mail included. The result's `folder` says which was read.

providerstring · optionalstringoptional

Mailbox provider kind: gmail, outlook or auto (default). This is NOT an account — to target one specific mailbox, use accountId.

One of: gmail, outlook, auto

accountIdstring · optionalstringoptional

The mailbox to use: an `account` value (name or address) from connector-list-accounts, which says whose each mailbox is. In chat, omit it when the person has one mailbox of their own; when several are available the call returns them so you can pick or ask. In a Workflow, a step uses only mailboxes the person who added it may use: omitting it picks their default (else newest) one, and a named one they may not use is refused, never replaced by another.

Get started

How to use this action

  1. Connect your AI

    Add Connie to ChatGPT, Claude or Slack once, then connect your account for this app. There’s no API key to manage.

  2. Ask for the outcome

    Describe what you need in plain words. Your AI runs this app’s actions when the job calls for them, along with any other tools it needs.

  3. Make it a workflow

    Add an action as a step in a workflow that runs the same way every time, on a schedule or when something happens.

  4. Stay in control

    Choose whether each action runs on its own or asks first. When it asks, you see an Allow or Deny card before anything changes in the app.