PostPilotIntegration Guide

PostPilot Integration Setup

Connect PostPilot to WarpWare via email. When PostPilot sends order export reports, WarpWare automatically picks them up and routes every order into the fulfillment pipeline.

How It Works

PostPilot sends
Daily order export reports as CSV email attachments to your designated inbox
WarpWare monitors
Your dedicated inbox every few minutes via IMAP, looking for new attachments
Orders ingested
CSV attachments are parsed and orders enter the fulfillment pipeline automatically
Setup Steps

Connect PostPilot to WarpWare

1

Create a dedicated email inbox

Create or designate an email address that will receive PostPilot order exports — for example, [email protected] or [email protected].

Tip: A dedicated inbox keeps PostPilot emails isolated and prevents WarpWare from accidentally processing unrelated emails. Gmail works best.
2

Enable IMAP and generate an App Password

WarpWare connects via IMAP to read your inbox. For Gmail accounts with 2-Factor Authentication (recommended), generate an App Password:

Google AccountSecurity2-Step VerificationApp passwords
Name the app password something like "WarpWare Email Scraper"
Copy the generated 16-character password — you'll enter it in WarpWare
Also enable IMAP: Gmail Settings → See all settings → Forwarding and POP/IMAP
3

Configure PostPilot to send reports to that inbox

In PostPilot, set up automated order export notifications to deliver to your dedicated inbox. The CSV or Excel attachment will contain the order data WarpWare needs.

WarpWare looks for CSV and Excel file attachments. Make sure PostPilot is configured to attach the order file — not just include a download link in the email body.
4

Connect the inbox in WarpWare

In WarpWare, navigate to Integrations → Add Connection and select Email Scraper. Enter:

Email address (the inbox you set up)
Email account password
App Password (from Step 2)
IMAP Server: imap.gmail.com (or your provider)
Sender Filter (recommended): In Advanced Settings, add PostPilot's sending address (e.g. [email protected]) as a sender filter. This ensures only PostPilot emails are processed, nothing else that lands in the inbox.
5

Test and activate the connection

Before activating, click Test Connection in WarpWare. This verifies IMAP access without processing any emails. Once the test passes, click Activate Connection.

Connection test passes
Authentication verified
Inbox access confirmed
Polling starts immediately
6

Verify your first import

WarpWare polls the inbox every few minutes. After activating, any existing unread PostPilot emails with CSV attachments will be processed automatically. To verify:

Go to Orders in WarpWare — PostPilot orders appear with source "email"
Check Logs → PostPilot Reports for ingestion history and batch stats
Each batch shows total orders, success/fail counts, and the source filename

Frequently Asked Questions

How often does WarpWare check for new emails?
WarpWare polls your configured inbox every few minutes. New PostPilot emails are typically picked up and processed within 5 minutes of arrival.
What file formats does WarpWare accept?
CSV, Excel (.xlsx, .xls), and plain text (.txt) by default. PDF order files are also supported if you enable that option and have a Rosetta mapping configured for your PDF format.
Will WarpWare process old emails already in the inbox?
Yes — on first activation, WarpWare processes any existing unread emails matching your configuration. If you want to avoid this, mark old PostPilot emails as read before activating.
What if PostPilot sends a duplicate order file?
WarpWare's duplicate detection checks order IDs. If an order with the same ID already exists for your client, it is skipped. You can monitor skipped orders in the PostPilot Reports log.
Can I connect multiple PostPilot inboxes?
Yes — you can connect multiple email scraper configurations, each monitoring a different inbox. Each connection is independent and can be scoped to a different sub-client.

Need help with setup?

Contact Support