Connectors
How to use Google Drive, Gmail, Sheets, Slack, QuickBooks, and Shippo from DocAI Settings - and why each one matters.
Connectors let your org pull documents in and send results out without leaving DocAI. Open Settings → Connectors while signed in.
The product story is extract → act: DocAI reads the PDF, then the connector writes the outcome into the systems your team already runs (Drive, mail, sheets, Slack, books, shipping).
Drive and Gmail extracts use the same credits and modes (Lite / Plus / Pro / Ultra) as workstation uploads. The Connectors panel defaults to Plus (2 credits/page). Change the mode at the top of the panel before you extract.
Business value
| Connector | Business value |
|---|---|
| Google Drive | Stop downloading PDFs one-by-one. Ops opens shared folders and extracts in place - fewer swivel-chair steps between Drive and DocAI. |
| Gmail | Turn inbound invoice / packing-slip email into structured data without saving attachments first. Ideal for AP and fulfillment inboxes. |
| Google Sheets | Land extract fields in a living ops sheet (audit, handoff, BI) without CSV export or copy-paste. |
| Slack | Surface “done / needs review / failed” where the team already works, so exceptions don’t sit unread in email. |
| QuickBooks Online | Close the AP loop: invoice extract → bill in QBO. Cuts retyping vendor, totals, and dates into accounting. |
| Shippo | Close the shipping loop: address on the document → validate → live carrier rates (and track). Cuts retyping into Shippo / carrier sites and catches bad addresses before a label ships. |
One-liner for proposals: DocAI turns documents into actions in the tools you already use - intake, notify, book, and ship - not just another JSON download.
What each connector is for
| Connector | You use it to |
|---|---|
| Google Drive | Open PDFs from Drive and extract them |
| Gmail | Open PDF attachments from email and extract them |
| Google Sheets | Append extract fields as a new spreadsheet row |
| Slack | Get a channel message when an extract finishes, needs review, or fails |
| QuickBooks Online | Create a bill from invoice JSON |
| Shippo | Validate ship-to addresses, get carrier rates, and track shipments |
Google Drive
Value: Shared Drive folders become an intake queue - extract without leaving DocAI.
- Go to Settings → Connectors.
- On Google Drive, click Connect and approve access in Google.
- When you return, the card should say Connected.
- Choose a PDF from the list and click Extract.
Gmail
Value: Inbound PDF attachments (invoices, packing slips) become extracts from the mailbox itself.
- Click Connect on Gmail and approve access.
- DocAI lists recent PDF attachments.
- Choose an attachment and click Extract.
Google Sheets
Value: Every extract can land as a row for ops tracking, handoff, or reporting - no CSV dance.
- Click Connect on Google Sheets and approve access.
- Select a spreadsheet from the list.
- Paste or provide extract JSON, then click Append row.
Values are written as plain text (not evaluated as formulas).
Slack
Value: Your team hears about extract outcomes in-channel, so review and failures get attention faster.
Connect Slack
- Go to Settings → Connectors.
- On Slack, click Connect.
- Approve DocAI for your Slack workspace.
- Return to Settings. Slack should show Connected.
Choose a channel and test
- In Slack, open the channel that should get alerts.
- Invite the DocAI bot:
/invite @DocAI- Copy the channel ID. It starts with
C(not a user id starting withU):- In Slack desktop: open channel details and scroll to the ID, or
- Open the channel in a browser and copy the
C…part of the URL.
- In DocAI, paste that id into Channel ID.
- Click Save channel.
- Click Send test. You should see a short confirmation message in Slack.
Alerts stay off until a channel is saved. Send test is available only after Slack is connected and a channel is saved.
After that, DocAI can post when an extract completes, needs review, or fails (notify-on-extract is on by default once a channel is saved).
Note: If Slack says sending messages to the DocAI app is turned off, that only affects DMs to the app. Channel notifications still work after you invite the bot and save a C… channel id.
QuickBooks Online
Value: Invoice extract → bill in the books. AP spends less time retyping vendors and amounts.
- Click Connect on QuickBooks Online and authorize your company (sandbox with Development keys; production later).
- Click Load accounts, pick an expense account, then Save account (Id must be numeric).
- Paste invoice JSON and click Create bill. Missing vendors are looked up by name and created if needed.
There is no separate “sandbox mode” toggle inside QuickBooks itself - with Development keys, Connect uses a sandbox company.
Shippo
Value: Shipping docs → validated address → live carrier rates (and tracking) without retyping into Shippo. Fewer bad labels and faster rate shopping for fulfillment / 3PL teams.
- From your Shippo account, copy an API key (start with a test key such as
shippo_test_…). - In Settings → Connectors → Shippo, paste the key and click Connect.
- When connected you can:
- Validate address - paste ship-to JSON (from an extract or sample) and check it with Shippo.
- Get rates - set ship-from, ship-to, and weight (oz); DocAI returns carrier / service / price / ETA.
- Track - enter carrier + tracking number for status.
- Prefer test keys until you are ready for live labels. Label purchase from DocAI is not in this panel yet; validate + rates are the demo path for extract → ship.
Example ship-to JSON:
{
"name": "Jane Receiver",
"street1": "215 Clayton St",
"city": "San Francisco",
"state": "CA",
"zip": "94117",
"country": "US"
}Disconnect
Each card has Disconnect. That unlinks the connector for your DocAI org. You can connect again later from the same panel.
Troubleshooting
| Problem | What to try |
|---|---|
| Connect fails | Sign in again, then retry Connect. If it still fails, contact support. |
| Slack test fails | Confirm /invite @DocAI in that channel, and that the id starts with C. |
| Drive or Gmail list is empty | Confirm the Google account has PDFs or PDF attachments, or reconnect. |
| Sheets append fails | Confirm a spreadsheet is selected and the JSON is valid. |
| QuickBooks bill fails | Use Load accounts for a numeric expense Id; confirm the company is the one you authorized. |
| Shippo validate / rates fail | Confirm a test key if you expect sandbox behavior; check address fields (street1, city, state, zip, country). |
Related
- Extract for modes and field guidance
- Credits for how connector extracts spend credits
- Authentication if you call the API instead of the UI