Connect your app to Wave

Wave is an accounting and invoicing platform for small businesses. The Wave connector lets your Lovable app read and manage business, customer, product, invoice, estimate, vendor, account, sales tax, and transaction data through Wave’s GraphQL API. With Wave, your app can:

List businesses and read accounting metadata
Create and update customers, products, invoices, and estimates
Query accounts, sales taxes, vendors, and transaction data
Build small-business finance workflows on top of Wave data

The Wave connector connects to a single Wave account via OAuth. It’s a good fit for small-business dashboards, invoice workflows, customer management tools, and finance operations apps tied to a connected Wave business.

Common use cases and example apps

Example app	Example prompt	Description
Small-business finance dashboard	Use Wave and build a dashboard that shows my businesses, customers, unpaid invoices, and recent transactions.	Track Wave business activity in one workspace. The app reads accounting metadata, invoices, customers, and transactions so a business owner can monitor work without opening Wave.
Invoice management app	Use Wave and build an app where I can list invoices, filter by customer, and create draft invoices for new work.	Manage invoice workflows from a custom interface. The app works with Wave invoice and customer data, then stores internal workflow notes separately in your Lovable app.
Customer account portal	Use Wave and build a customer portal that shows invoice history and customer details for each account manager.	Give teams a focused view of customer billing data. The app reads Wave customers and invoices, then organizes them around your internal account management workflow.
Product and service catalog	Use Wave and build a catalog manager that lists my products and services and lets me update descriptions and prices.	Keep Wave products and services easier to review. The app reads and updates product records so your team can maintain billing items from a tailored interface.
Estimate tracking tool	Use Wave and build an estimate tracker that lists estimates, groups them by status, and helps me follow up with customers.	Turn Wave estimates into a sales follow-up workflow. The app reads estimate and customer data, then adds reminders, filters, and internal status tracking.
Vendor and expense overview	Use Wave and build an app that shows vendors, accounts, and recent transactions for my finance team.	Surface Wave accounting data for operations reviews. The app queries vendors, accounts, and transaction data so finance teams can review activity in a purpose-built view.

How to connect Wave

Workspace admins and owners can connect Wave when the connector is available in their workspace. Connector availability follows workspace app connector settings: enabled by default on Free, Pro, and Business plans, and disabled by default on Enterprise plans unless an admin enables it. You can create multiple Wave connections using different Wave accounts, which is useful for separating businesses, environments, or client accounts. When the connection is created, Wave becomes available across all projects in the workspace. Anyone building in a project can ask Lovable in chat to link their project to it.

Prerequisites

Before connecting Wave, make sure you have:

A Wave account you want to connect
Access to the Wave business data your app needs
Lovable workspace owner or admin role

All API requests made through this connector count against the limits and availability of your Wave account. Billing and quota are handled directly by Wave, not Lovable.

Set up your Wave connection

Open Wave in Connectors

Go to Connectors → App connectors and select Wave.

Add a connection

Click Add connection.

Name the connection

In Display name, name the connection (for example, Wave Main Business). This name is only used inside Lovable to identify the connection.

Review scopes (optional)

Expand Advanced settings to review the permissions your app requests. Default scopes are pre-selected for common Wave use cases.

Scope	What it allows	Default
User: read (`user:read`)	Read the authorized Wave user’s profile	Required
Business: read (`business:read`)	List and read Wave businesses available to the user	Required
Accounts: full access (`account:*`)	Read and manage accounting accounts	On
Customers: full access (`customer:*`)	Create, read, and update customers	On
Estimates: full access (`estimate:*`)	Create, read, update, and send estimates	On
Invoices: full access (`invoice:*`)	Create, read, update, and send invoices	On
Products: full access (`product:*`)	Create, read, and update products and services	On
Sales taxes: full access (`sales_tax:*`)	Create, read, and update sales taxes	On
Transactions: full access (`transaction:*`)	Write and manage money transactions	On
Vendors: full access (`vendor:*`)	Create, read, and update vendors	On

For full API documentation, see Wave’s API reference.

Choose who can access this connection

Under Who can access this connection, decide who in your workspace can use the connection:

Only you (default): only the person creating the connection can use it and its associated data.
Invite specific people: only you and explicitly added workspace members can use the connection and its associated data.
Invite entire workspace: click Invite entire workspace to make the connection available to everyone in your Lovable workspace.

See Who can manage connections for more information.

Connect to Wave and authorize

Click Connect. The Wave authorization window opens, so make sure your browser doesn’t block pop-ups. If it does, Lovable redirects you instead.Sign in to Wave if prompted, review the requested permissions, and click Allow.You’ll be redirected back to Lovable with a confirmation.

When connected, anyone building in a project can ask Lovable in chat to link their project to Wave (based on configured connection-level access). Your Lovable apps can then call Wave through the connector gateway and work with the Wave resources allowed by the selected scopes.

Limitations

The Wave connector cannot:

Access Wave resources outside the selected OAuth scopes
Access Wave businesses that the connected Wave account cannot access
Receive Wave webhooks or event notifications
Bypass Wave API limits, account availability, or plan restrictions
Support per-end-user Wave login. Each connection represents a single Wave account shared across all projects linked to it.

If Wave authorization is revoked from the Wave side, you’ll need to reconnect the integration in Lovable before API calls can succeed again.

How to unlink projects from a connection

Editors and above can remove specific projects from a connection without deleting the connection entirely. The connection will remain available for other projects. To unlink projects:

Open Connectors

Open Connectors and select .

Open the connection

Open the connection you want to manage.

Select projects

Under Linked projects, check the projects you want to unlink.

Confirm

Click Unlink projects and confirm.

When unlinked, those projects will no longer have access to through this connection. If a project needs again, you can link it to any available connection.

How to delete a connection

Workspace admins and owners can delete connections. Other members can delete a connection if they created it, or if they have been explicitly granted access to it.

Deleting a connection is permanent and cannot be undone. It will remove the credentials from all linked projects, and any apps using this connection will stop working until a new connection is added.

Before deleting, review the Linked projects section to see which projects are currently using the connection. To delete a connection:

Open Connectors

Open Connectors and select .

Open the connection

Open the connection you want to remove.

Review linked projects

Review the Linked projects section.

Delete

Under Delete this connection, click Delete and confirm.

About integrations

App connectors

Chat connectors (MCP)

Git

Common use cases and example apps

How to connect Wave

Prerequisites

Set up your Wave connection

Limitations

How to unlink projects from a connection

How to delete a connection

​Common use cases and example apps

​How to connect Wave

​Prerequisites

​Set up your Wave connection

​Limitations

​How to unlink projects from a connection

​How to delete a connection

Common use cases and example apps

How to connect Wave

Prerequisites

Set up your Wave connection

Limitations

How to unlink projects from a connection

How to delete a connection