DocAI
How it worksPricingDocsTrustCookies
Sign inStart free
DocAI Docs
DocAI Docs
ProductOpenAPIDocAI APIAuthenticationPythonExtractJobs & batchCreditsErrorsIdempotencyConnectorsMCP

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

ConnectorBusiness value
Google DriveStop downloading PDFs one-by-one. Ops opens shared folders and extracts in place - fewer swivel-chair steps between Drive and DocAI.
GmailTurn inbound invoice / packing-slip email into structured data without saving attachments first. Ideal for AP and fulfillment inboxes.
Google SheetsLand extract fields in a living ops sheet (audit, handoff, BI) without CSV export or copy-paste.
SlackSurface “done / needs review / failed” where the team already works, so exceptions don’t sit unread in email.
QuickBooks OnlineClose the AP loop: invoice extract → bill in QBO. Cuts retyping vendor, totals, and dates into accounting.
ShippoClose 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

ConnectorYou use it to
Google DriveOpen PDFs from Drive and extract them
GmailOpen PDF attachments from email and extract them
Google SheetsAppend extract fields as a new spreadsheet row
SlackGet a channel message when an extract finishes, needs review, or fails
QuickBooks OnlineCreate a bill from invoice JSON
ShippoValidate ship-to addresses, get carrier rates, and track shipments

Google Drive

Value: Shared Drive folders become an intake queue - extract without leaving DocAI.

  1. Go to Settings → Connectors.
  2. On Google Drive, click Connect and approve access in Google.
  3. When you return, the card should say Connected.
  4. Choose a PDF from the list and click Extract.

Gmail

Value: Inbound PDF attachments (invoices, packing slips) become extracts from the mailbox itself.

  1. Click Connect on Gmail and approve access.
  2. DocAI lists recent PDF attachments.
  3. 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.

  1. Click Connect on Google Sheets and approve access.
  2. Select a spreadsheet from the list.
  3. 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

  1. Go to Settings → Connectors.
  2. On Slack, click Connect.
  3. Approve DocAI for your Slack workspace.
  4. Return to Settings. Slack should show Connected.

Choose a channel and test

  1. In Slack, open the channel that should get alerts.
  2. Invite the DocAI bot:
/invite @DocAI
  1. Copy the channel ID. It starts with C (not a user id starting with U):
    • 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.
  2. In DocAI, paste that id into Channel ID.
  3. Click Save channel.
  4. 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.

  1. Click Connect on QuickBooks Online and authorize your company (sandbox with Development keys; production later).
  2. Click Load accounts, pick an expense account, then Save account (Id must be numeric).
  3. 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.

  1. From your Shippo account, copy an API key (start with a test key such as shippo_test_…).
  2. In Settings → Connectors → Shippo, paste the key and click Connect.
  3. 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.
  4. 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

ProblemWhat to try
Connect failsSign in again, then retry Connect. If it still fails, contact support.
Slack test failsConfirm /invite @DocAI in that channel, and that the id starts with C.
Drive or Gmail list is emptyConfirm the Google account has PDFs or PDF attachments, or reconnect.
Sheets append failsConfirm a spreadsheet is selected and the JSON is valid.
QuickBooks bill failsUse Load accounts for a numeric expense Id; confirm the company is the one you authorized.
Shippo validate / rates failConfirm 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

Idempotency

Retry extract without a second charge using Idempotency-Key. GET routes are always safe to retry.

MCP

Connect Cursor, Claude, Codex, VS Code Copilot, and other agents to DocAI over Streamable HTTP.

On this page

Business valueWhat each connector is forGoogle DriveGmailGoogle SheetsSlackConnect SlackChoose a channel and testQuickBooks OnlineShippoDisconnectTroubleshootingRelated