📩 Outlook Inbox Reader

Process and structure your Outlook or Office 365 inbox with full control.
This actor connects to Microsoft Graph API, retrieves emails based on your filters, and saves structured results to an Apify Dataset. Attachments are stored in Apify Key-Value Store and linked to your dataset for easy download.

---

✨ Key Features

• ✅ Application & Delegated auth modes supported
• ✅ Filter by sender, subject, body text, date range, unread/read
• ✅ Choose folders (Inbox, All Mail, custom)
• ✅ Download attachments with filename/extension/size filters
• ✅ Store bodies (bodyHtml, bodyText) in dataset
• ✅ Flattened recipient columns (to, cc, bcc)
• ✅ Quick columns for attachment names & paths + full attachment array
• ✅ Mark emails as read (optional)

---

🛠 Use Cases

1. Job Applications & HR

• Connect to careers@company.com
• Collect all incoming resumes + cover letters
• Filter by attachment extension .pdf or .docx
• Dataset contains applicant email, subject, body (cover letter), and links to CVs

2. Customer Support & Inquiries

• Collect support tickets from support@domain.com
• Filter by subject (“urgent”, “complaint”) or sender domain
• Store structured dataset with customer details and attachments
• Export into helpdesk or CRM

3. Invoices & Billing Automation

• Watch billing@domain.com mailbox
• Collect invoices automatically from vendor emails
• Filter attachments for .pdf invoices
• Dataset outputs invoice sender, subject, and KV path to saved files
• Perfect for accounting workflows

4. Sales & Lead Capture

• Track inbound leads from forms/partners
• Extract sender email + phone numbers via regex in body
• Attach proposals or pitch decks saved in KV
• Export dataset to HubSpot, Salesforce, or Google Sheets

5. Orders & Logistics

• E-commerce sellers can monitor order confirmations from Amazon, eBay, Shopify
• Filter by known sender domains
• Extract order numbers from subject/body
• Archive invoices and order PDFs

6. Legal & Compliance

• Centralize and archive contracts, NDAs, compliance documents
• Store both email metadata and attachments
• Dataset serves as compliance evidence

7. Research Monitoring

• Subscribe to newsletters (Google Scholar alerts, industry news)
• Dataset becomes a structured archive of reports
• Attachments (PDF reports) automatically stored

8. Marketing Campaign Responses

• Track replies to mass email campaigns
• Filter by “unsubscribe” keyword in body
• Dataset of opt-outs for updating mailing lists

9. Project Management

• Contractors/vendors email updates with project code in subject
• Filter by keyword [PROJECT-X]
• Dataset provides central log of updates and attachments

10. Personal Productivity

• Download receipts from services (Uber, Amazon, Airbnb)
• Filter by sender domain
• Dataset integrates into expense trackers

---

⚙️ Input Options

• authMode → application or delegated
• tenantId, clientId, clientSecret → Required for application mode
• userAccessToken → Required for delegated mode (Hotmail/Outlook.com personal accounts)
• mailboxes → One or more tenant mailbox addresses (e.g. reports@yourdomain.com)
• Filters:
  • dateFrom, dateTo → ISO date strings
  • senderEmails → CSV or JSON array
  • subjectIncludes, bodyIncludes
  • onlyUnread → boolean
• Attachment filters: includeAttachments, attachmentExtensions, attachmentMinSizeKB, attachmentMaxSizeKB, attachmentNameIncludes, attachmentNameExcludes
• markAsRead → Mark processed emails as read
• maxMessagesPerMailbox → Limit number of messages processed

---

📦 Output Format

Each dataset item includes:

• mailbox
• id (Graph message ID)
• receivedDateTime, sentDateTime
• subject
• from, to, cc, bcc (flattened)
• isRead
• bodyPreview, bodyHtml, bodyText
• conversationId
• attachmentNames (comma-separated)
• attachmentPaths (comma-separated KV keys)
• attachments array with full details

---

🔑 How to Get Microsoft Credentials

To use this actor you must register an app in Azure Active Directory (Entra ID):

1. Open Azure Portal
   Go to https://portal.azure.com

2. Register a new application

   • Navigate to Azure Active Directory > App registrations > New registration
   • Enter a name (e.g. “Apify Inbox Reader”)
   • Supported account types:
     • Application mode → “Accounts in this organizational directory only”
     • Delegated mode → can include personal Microsoft accounts
   • Redirect URI: leave empty unless you plan to use delegated auth with OAuth flow

3. Collect Tenant ID and Client ID

   • After registration, open the app → Overview
   • Copy Directory (tenant) ID → use as tenantId
   • Copy Application (client) ID → use as clientId

4. Create Client Secret

   • App page → Certificates & Secrets → New client secret
   • Add description + expiration
   • Copy the generated value immediately → use as clientSecret

5. Assign API Permissions

   • App page → API permissions > Add a permission
   • Choose Microsoft Graph
   • For Application mode: Application permissions > Mail.Read
   • For Delegated mode: Delegated permissions > Mail.Read
   • Click Grant admin consent

6. Use the Credentials in the Actor

   • For Application mode: provide tenantId, clientId, clientSecret, and list of tenant mailbox addresses
   • For Delegated mode: provide a valid userAccessToken (generated with OAuth 2.0 Authorization Code Flow)

---

✅ With this actor you can turn any Outlook inbox into a structured dataset: HR CV collector, invoice automation, order archive, compliance logs, and more.