Connect a document source

Let Invoyz collect invoices from a mailbox, OneDrive, Google Drive or via Peppol.

With a document source, Invoyz collects invoices itself. You can choose from Microsoft 365 / Outlook, Google Workspace / Gmail, OneDrive, Google Drive, IMAP (other) and Peppol.

Connect a source

  1. Go to Settings > Document sources, or open a company and go to the Document sources tab.
  2. Click Connect source.
  3. Under Type, choose the kind of source and give it a Name, for example Purchase mailbox.
  4. Choose the Company the invoices belong to, if it is not filled in yet.
  5. Optionally set Reading since to an earlier date to also process older emails.
  6. Click the connect button and sign in with the provider, or enter the server details for IMAP.
  7. Choose the folder Invoyz should read and click Save.

Per type

  • Microsoft 365 / Outlook: sign in with the mailbox account; Invoyz only gets read access. Enter an address under Shared mailbox to read a shared mailbox. Seeing 'Need admin approval'? Send the admin link to your Microsoft administrator and try again afterwards.
  • Microsoft 365 / Outlook without sign-in: under Access choose Without sign-in (app access, set up by the admin). Nobody signs in and Invoyz can only read the one mailbox the admin allows. Enter the Microsoft 365 tenant and the Mailbox. The Microsoft admin runs the script Invoyz shows once. After that it often takes 1 to 2 hours before you can connect.
  • Google Workspace / Gmail: sign in with the mailbox's Google account; Invoyz only gets read access. If Google shows an unverified app warning, choose 'Advanced' and 'Continue'.
  • IMAP (other): enter the IMAP server, Port, Username and Password. Prefer an app password. The default is port 993 with SSL/TLS.
  • OneDrive and Google Drive: pdf, xml and zip files in the chosen folder are processed. A pdf and xml with the same name are imported together as one invoice. Files are never moved or deleted.
  • Peppol: register the company on the Peppol network. See the article about activating Peppol.

For mailboxes, only emails with attachments in the chosen folder are processed. Invoyz never changes or deletes anything in the mailbox.

Only process invoices

Does the source also receive other emails, such as questions, payment requests or reminders? Then choose which documents are processed. This works for sources that go to the Central mailbox.

  1. Go to Settings > Catch all mailbox.
  2. Under Allowed document types, pick for example Invoice and Credit note.
  3. Optionally pick Allowed categories as well, then save.

Other documents are ignored: no document is created and they are not forwarded. Leave a field empty to show All allowed and process everything.

Manage a source

Open a source to see when it was Last checked and which Checks have run. Click Check now to look for new documents right away. Use Check interval to set how often Invoyz checks the source.

Updated on 12 November 2026