Connecting Wave
Prerequisites
- An active Wave account with Wave Pro or Wave Advisors subscription (required for third-party integrations since May 2025)
- At least one business set up in Wave
- US or Canada only — Wave is exclusively available to businesses in the United States and Canada since November 2020
Steps
- Click Authorize to start the OAuth flow
- Log in to your Wave account (if not already logged in)
- Grant access to the requested scopes
- You'll be redirected back — the connection will show as Connected
- Enter your Business ID in the settings:
- Log in to Wave at app.waveapps.com
- Navigate to a business — the URL will contain your Business ID
- Copy the ID (it looks like
QnVzaW5lc3M6..., a base64-encoded string)
- Click Save
Settings
| Setting | Required | Description |
|---|---|---|
| Business ID | Yes | The ID of your Wave business (found in the Wave app URL) |
Supported Features
| Feature | Support |
|---|---|
| Customers | Read, Create, Update, Delete |
| Suppliers/Vendors | Read only |
| Invoices | Read, Create, Delete |
| Chart of Accounts | Read, Create |
| Products/Services | Read, Create, Update |
| Tax Rates | Read |
| Company Info | Read |
| Bank Accounts | Read |
| Balance Sheet | Read (computed) |
| Profit & Loss | Read (computed) |
| Bank Feed Statements | Read |
Limitations
- Geographic restriction: Wave only supports businesses in the US and Canada. Only USD and CAD currencies are supported.
- Paid plan required: End users must have an active Wave Pro subscription ($19/mo) to authorize third-party integrations.
- No bills/journal entries: Wave's API does not expose bills or journal entries as API resources.
- Invoice line items: Line items are only available when fetching a single invoice, not in list responses.
Troubleshooting
| Issue | Solution |
|---|---|
| "Not Connected" after authorization | Ensure you have an active Wave Pro subscription |
| "No data returned" | Verify the Business ID is correct |
| "Unauthorized" error | Re-authorize — your token may have expired |
| Can't find Business ID | Check the URL when viewing your business in Wave |
| Can't sign up for Wave | Wave is US/Canada only — businesses outside North America are redirected to Zoho Books |