Connecting Wave

Prerequisites

• An active Wave account with Wave Pro or Wave Advisors subscription — required for the business you are connecting. If you are a developer testing your own application against your own account, you do not need a paid subscription for that testing.
• 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

1. Click Authorize to start the OAuth flow
2. Log in to your Wave account (if not already logged in)
3. Grant access to the requested scopes
4. You'll be redirected back — the connection will show as Connected
5. Enter your Business ID in the settings:
   • Log in to Wave at app.waveapps.com
   • Open the business you want to connect — its URL looks like https://app.waveapps.com/businesses/{business_id}
   • Copy the {business_id} segment (a base64-encoded string, e.g. QnVzaW5lc3M6...)
6. Paste it into the Business ID field and click Save

Settings

Setting	Required	Description
Business ID	Yes	The ID of your Wave business — the base64 segment of your Wave app URL, https://app.waveapps.com/businesses/{business_id}

Supported Features

Feature	Support
Customers	Read, Create, Update, Delete
Suppliers/Vendors	Read only
Invoices	Read, Create, Delete (no Update)
Invoice Items	Read, Create, Update
Ledger Accounts (Chart of Accounts)	Read, Create
Tax Rates	Read only
Company Info	Read only
Bank Accounts	Read only
Bank Feed Statements	Read only
Balance Sheet	Read only (computed)
Profit & Loss	Read only (computed)

Limitations

• Geographic restriction: Wave only supports businesses in the US and Canada.
• Paid plan required for connecting businesses: the Wave business you connect must have an active Wave Pro or Wave Advisors subscription. This does not apply if you are only testing your own application against your own account.
• No bills, bill payments, or journal entries: Wave's API does not expose these as resources at all.
• Invoices cannot be updated: invoices support create and delete, but not update, once posted.
• Invoice line items: not returned. line_items is always empty on Wave invoices, for both list and single-invoice reads — fetching an invoice individually does not surface them.
• Suppliers, tax rates, company info, bank accounts, bank feed statements, balance sheet, and profit and loss are read-only.

Troubleshooting

Issue	Solution
"Not Connected" after authorization	Ensure the connecting business has an active Wave Pro or Wave Advisors subscription
Connection stops working after previously working	If the connected business's Wave Pro or Advisors subscription has lapsed, the next token refresh returns a 403 error and the connection stops working. Reactivate the subscription to restore it.
"No data returned"	Verify the Business ID is correct
"Unauthorized" error	Re-authorize — your token may have expired
Can't find Business ID	Open the business in Wave and copy the ID segment from the URL: https://app.waveapps.com/businesses/{business_id}