- 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
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
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.
For full API documentation, see Wave’s API reference.
| 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 |
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.
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.
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.
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:
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.