> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lovable.dev/llms.txt
> Use this file to discover all available pages before exploring further.
# Connect your app to Wave
> Connect your app to Wave, an accounting and invoicing platform, to build apps that work with customers, products, invoices, estimates, and business accounting data.
export const connector_0 = "Wave"
[Wave](https://www.waveapps.com/) 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
Go to **Connectors → App connectors** and select **Wave**.
Click **Add connection**.
In **Display name**, name the connection (for example, `Wave Main Business`). This name is only used inside Lovable to identify the connection.
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](https://developer.waveapps.com/hc/en-us/articles/360019968212-API-Reference).
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](/integrations/introduction#who-can-manage-connections) for more information.
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 {connector_0} 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**, then go to **App connectors**, and select **{connector_0}**.
Open the connection you want to manage.
Under **Linked projects**, check the projects you want to unlink.
Click **Unlink projects** and confirm.
When unlinked, those projects will no longer have access to {connector_0} through this connection. If a project needs {connector_0} again, you can link it to any available connection.
## How to delete a {connector_0} connection
Workspace admins and owners can delete {connector_0} 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**, then go to **App connectors**, and select **{connector_0}**.
Open the connection you want to remove.
Review the **Linked projects** section.
Under **Delete this connection**, click **Delete** and confirm.