Choose an integration

Available sources

• Vercel: access-token connection, historical import, and daily automatic collection.
• Cloudflare (beta): an API token with Billing Read plus the account ID; collects the account’s invoices daily like Vercel. Reconnect the token if Cloudflare reports it cannot read billing.
• DigitalOcean (beta): a personal access token with the billing:read custom scope, created by a team member who can see billing; collects each month’s invoice daily. The running month’s preview is never collected.
• Scaleway (beta): the secret key of an API key whose application has BillingReadOnly on the Organization, plus the Organization ID; collects the Organization’s invoices daily.
• OVHcloud (beta): the application key, application secret and consumer key from OVHcloud’s token page for your region, allowed to read /me/bill and /me/bill/* only; collects bills daily.
• Mailboxes: invoice PDF attachments from an IMAP folder, collected when you choose Sync.
• Hostinger: manual billing-dashboard collection using a saved browser session. This connection is in beta.
• OpenAI API (beta): new invoices forwarded to your workspace address by OpenAI, and the older ones added once from a saved or copied Billing history page.
• ChatGPT (beta): the same for ChatGPT subscriptions, from ChatGPT’s Billing settings.

Send invoices by email

Every workspace has its own forwarding email, shown under Forwarding email in Settings; a mailbox such as Gmail is something else, connected on Integrations. Forward an invoice email to it, or give the address to a supplier as your billing email. PDF attachments are stored as invoices as soon as the email arrives; other attachments and the message text are not kept.

A service you give the address to usually confirms it first: Gmail before it forwards, a supplier before it bills you there. That confirmation is a code or a link sent to the address itself, so kvitr shows it for you. It appears in To do on Home and under Forwarding email in Settings, with the code to paste back and a link that only ever goes to the service that asked. Choose Done once the address works; a confirmation nobody uses disappears within a day.

One record per invoice: when an email carries both an invoice and its receipt (payment services such as Stripe attach both), or the same PDF reaches kvitr twice, only one invoice is kept. The invoice counts, not the receipt; a receipt that arrived first is replaced by the invoice when it turns up. The Feed on Home shows a badge per file under such an invoice, and its Details list the other documents. Documents with the same number but a different total or date are kept apart, and credit notes are never merged.

An email from a business address is filed under that supplier. When you forward an email from a personal mailbox, kvitr looks for the supplier printed on the PDF (its company ID or legal name) and for senders you filed before. An email it cannot match is kept as New email on Home and in Invoices until you choose its supplier; a mailbox such as gmail.com is never turned into a supplier. Mail from your own company’s domains (Workspace in Settings) is never filed as a supplier either.

The address is made from your workspace name, for example test-aps@kvitr.com, so suppliers can read it. A workspace that still has one of the earlier random addresses can switch in Settings: choose Use company name next to the address. Mail sent to the old address keeps arriving too, because services often go on billing an address you once gave them; Settings lists it under the new one. Copy the address from Settings whenever you need it.

Keep sources in the right workspace

Choose the intended workspace before adding a connection. Its invoices are collected into that workspace and are visible to its members according to their access level.

Each Vercel connection represents one Vercel team. Each mailbox connection reads one folder. You can add separate connections for other teams or folders.

Sync and historical collection

Sync asks a source for new invoices. For Vercel, it schedules collection in the background. Manual sources run their collection when requested.

Use Import historical invoices on a Vercel connection to extend its history. Mailboxes use the Mailbox history period, set from a mailbox source’s row menu on Connect. Repeating a sync on the same connection skips invoices it has already collected.

While a source is collecting, a spinner sits beside Integrations in the sidebar. You can keep working; the page updates itself when the collection finishes, so there is nothing to reload.

Disconnect a source

Disconnect removes the saved connection credentials and stops future collection through that connection. PDFs already collected stay in the workspace.

Disconnecting kvitr does not revoke the credential at the provider. You can also revoke its token, app password, or session in the provider’s account settings. See Privacy and security.