Save Hours Setting Up Xero Hubdoc: Checklist for Bookkeepers

Create a Hubdoc organization from Xero: roles, unique email, and initial settings

Creating the organization takes a few minutes, but the role and email choices you make here shape how the integration behaves for months to come.

Confirm you hold the subscriber, administrator, or master administrator role in Xero. Anyone below that level cannot create the Hubdoc organization, and if a client needs their own separate organization, they must do this from their own Xero login.
Log into Xero, click the organization name in the top left, select “Do more with Xero,” then choose “Hubdoc” and click “Set up Hubdoc.”
Accept the terms when prompted. Xero will create the Hubdoc organization and link it automatically to the Xero organization you were in.
Check that the unique Hubdoc email address was generated, since each Hubdoc organization needs a distinct email and you cannot reuse one that is already tied to another organization.
If you manage several client organizations from one inbox, use an alias such as yourname+clientname@domain.com rather than creating a separate mailbox for each one.
Turn on settings for creating documents from attachments and, where a supplier sends invoice details in the email body rather than as a file, from the email body text as well.

That unique email address is the single most common setup snag, so confirm it before moving on.

Connect an existing Hubdoc organization to Xero and verify permissions

If a Hubdoc organization already exists, for instance one a client set up before hiring you, you connect it to Xero rather than creating a new one.

Open Hubdoc, go to the integration settings, and select “Allow access” to start the single sign-on handshake with Xero.
Log in with the Xero credentials for the organization you want to connect, and approve the permission request.
Confirm the connection worked by checking “Destinations” in Hubdoc for a Xero entry, and by checking “Files” or draft transactions inside Xero.
Connect using a dedicated administrative account rather than a personal staff login, since the integration inherits the role of whoever performs the connection, and that inheritance determines who can later publish into Xero.

Skipping that last point is how firms end up with publish permissions mapped to the wrong person months later.

How to ingest documents into Hubdoc: mobile, web, email, and supplier fetch

Hubdoc accepts documents through several channels, and most practices end up using two or three depending on the client.

Use the mobile app to photograph a receipt on the spot, or upload multiple images at once from your device’s camera roll.
Upload from a desktop browser with drag and drop, and if a single PDF contains several separate receipts, add “#split” to break it into individual documents.
Email documents to the organization’s unique Hubdoc address, and add “#note [text] #note” in the email body to attach a custom note to the document. Documents can enter Hubdoc through any of these channels or through automated supplier fetch.
Set up a forwarding rule in Gmail or Outlook so recurring supplier emails, like utility bills or software invoices, route to Hubdoc automatically instead of requiring a manual forward each month.
Turn on supplier fetch where it is available for a given vendor, which pulls statements or invoices directly from the supplier’s portal without anyone forwarding an email at all.

Email forwarding rules vary by mail client, so check the built-in instructions in Gmail or Outlook rather than guessing at the filter syntax.

Supplier rules, autosync, and publishing documents to Xero

Supplier rules are what turn Hubdoc from a scanner into something closer to a coding engine. Supplier rules configure how recurring documents are coded and published, which is the feature that actually saves time at scale.

Open a document, review the extracted fields, and click “Publish” to send a single item to Xero as a draft.
To automate a recurring supplier, go to Integrations, select “Autosync to Xero Files,” configure the coding rules for that supplier, then turn on “Auto-sync.”
Know the attachment behavior before you rely on it: files under 3MB attach directly to the Xero transaction, while larger files show up as a link instead.
Save the supplier rule once it is configured correctly, and set it to forward a copy to cloud storage if you want a backup outside Xero.

Pro Tip: Enable autosync for one supplier first, confirm the draft transaction lands correctly in Xero, and only then roll the rule out across the rest of that client’s suppliers.

Invite staff, set permissions, and recommended practice workflows

Permissions in Hubdoc map onto what happens in Xero, so get the sequence right before documents start flowing.

Grant “Publish Documents” permission only to staff who should be able to send items into Xero, since anyone with that permission can publish even during a lock period if the connecting account was an administrator.
Have the practice admin create the organization and invite the client and staff afterward, rather than letting a client set up their own org and then invite the firm.
Assign one person to review extracted data for accuracy, a second to publish once approved, and set lock dates in Xero so published items cannot be altered after a period closes.

Practice and billing notes: partner edition differences and client organization setup

Firms managing several clients should start with a partner organization rather than building settings client by client.

Create a free Hubdoc partner organization first and use it to test ingestion, supplier rules, and autosync before touching a live client account.
Create each client’s Hubdoc organization from Partner Hub once your workflow is confirmed, which keeps settings consistent across accounts.
Confirm billing before switching on autosync broadly. Hubdoc is included with most Xero business plans, but Partner Edition subscriptions bill Hubdoc separately, and that distinction affects what a client sees on their invoice.

Common setup issues and a quick troubleshooting checklist

Most Hubdoc problems trace back to one of four causes, and each has a quick fix.

If the connection fails, confirm the account used has administrator or subscriber access in Xero, check for a blocked single sign-on pop-up, and re-authenticate if the session timed out.
If an attached document shows up as a link instead of a file in Xero, it is likely over 3MB, which is expected behavior rather than an error.
If a multi-page PDF is coming through as one merged document, add “#split” to the email subject line before forwarding it again.
If you get a “this email is already in use” error, that email is tied to another Hubdoc organization already, so switch to an alias like yourname+client@domain.com.
If autosync is not firing, check the supplier rule configuration under Integrations and review the Hubdoc activity log for the specific document before assuming the integration itself is broken.

Tolliver Team’s practical checklist and admin governance tips

A few habits keep Hubdoc running cleanly once several clients are on it.

Always connect a new organization with a dedicated admin account so publish permissions map to the right person, not whoever happened to be logged in that day.
Standardize supplier rules and naming conventions across clients so a new team member can step into any account without relearning the setup.
Run a short onboarding checklist for every new client: test ingestion with a real receipt, enable autosync on one supplier, confirm the draft transaction in Xero, then train the client on email forwarding.

Pro Tip: Keep a written supplier rule template for common vendor types like utilities, software subscriptions, and fuel, so setting up a new client’s rules takes minutes instead of an afternoon.

Tolliver Bookkeeping and Tax shares client documents through a secure Client Hub portal, which pairs well with Hubdoc as a second layer of document backup.

Tolliver Team perspective: efficiency gains and real tradeoffs

Rolling out Hubdoc across client accounts cuts the time spent on manual data entry and makes month-end reconciliation noticeably cleaner once autosync is dialed in correctly. The tradeoff is real: supplier rules need testing before they run unattended, and clients need a short training session on email forwarding or they will keep emailing receipts directly to their bookkeeper instead. Migration side of this can be less painful for clients switching from other software with the right support.

— Tolliver Team

How Tolliver can help with Xero and Hubdoc setup, migration, and ongoing bookkeeping

Setting up Hubdoc correctly the first time saves hours of cleanup later, and that is the part most business owners would rather hand off. Tolliver Bookkeeping and Tax migrates clients to Xero at no cost, configures Hubdoc and supplier rules, and trains staff on the forwarding habits that keep documents flowing without manual chasing.

Migration includes a full setup checklist, Hubdoc configuration, and staff training so nothing gets missed during the switch.
Documents move through our secure Client Hub portal in addition to Hubdoc, giving clients a second place to find anything we’ve filed.
Once setup is done, our bookkeeping service covers monthly reconciliation with an eye toward what shows up on your return later.

If you would rather hand the setup to someone who does this daily, schedule a consultation and we’ll walk through your current bookkeeping and where Hubdoc fits.

Sources

These are the primary sources behind the setup steps above, along with further reading on related workflows like bank reconciliation and receipt capture.

For a broader look at what being Xero certified means for a practice’s admin efficiency, see this partner perspective on certification benefits.

FAQ

Is Hubdoc still free with Xero?

Hubdoc is included with most Xero business plans at no extra charge, but Partner Edition subscriptions bill Hubdoc separately, so check your specific plan before assuming it’s bundled. Confirm this with your Xero subscription details rather than assuming based on a colleague’s plan.

How do I set up Hubdoc?

Log into Xero, click the organization name, select “Do more with Xero,” choose Hubdoc, and click “Set up Hubdoc” to create a new organization automatically linked to Xero. Only a subscriber, administrator, or master administrator can complete this step, and you’ll want to confirm the unique Hubdoc email and initial document settings right after.

What does Hubdoc do with Xero?

Hubdoc extracts key data such as invoice date, due date, supplier name, and amount from bills and receipts, then creates draft transactions in Xero so you avoid manual data entry. You can publish documents one at a time or set up autosync so recurring supplier documents flow into Xero automatically.

How can I access Hubdoc using Xero?

Open your Xero organization, go to “Do more with Xero,” and select Hubdoc to access your connected organization directly, no separate login required if you’re already signed into Xero. If Hubdoc was set up as a standalone organization first, you’ll instead connect it through the single sign-on handshake described in the setup steps above.

Save Hours Setting Up Xero Hubdoc: Checklist for Bookkeepers

Recent Posts

Archives

Table of Contents