Wave

Service ID: wave

Free accounting and invoicing software for small businesses. Includes invoicing, accounting, receipt scanning, and financial reporting.

Beta — this connector is in beta. Functionality and resource coverage may change.

At a Glance

Difficulty
MODERATESelf-Service OAuth App + Wave Approval Required to Distribute
Authentication
OAuth 2.0OAuth 2.0 authorization code flow. Wave's API is GraphQL-only, and each connection also needs the consumer's Wave Business ID.
Webhooks
No webhooks — none surfaced by this connector, so poll for changes.
Partnership Required
No
Apideck Credentials
Not available(Not available — register your own Wave application and add its Client ID and Secret to Apideck.)
Costs
Wave charges no API access fees and commits to advance notice before introducing any. The subscription requirement sits on the connecting business, not you.
Sandbox Availability
Not available(No sandbox environment. A free Starter account is a sufficient test environment and exposes the same API surface as Pro.)
Account Type Required
A Wave business in the US or Canada with an active Pro or Advisors subscription. Testing your own app against your own account needs neither.
Consumer Access Level
Any user with access to the business can authorise the connection; Wave publishes no role requirement.
Rate Limits
Wave publishes no rate limits; its documented error codes include no throttling or rate-limit code.

Responsibility matrix

TaskYou (Customer)Your ConsumerApideck
Create a Wave account
Register the Wave applicationDocs provided
Obtain Wave's approval to distribute
Add Client ID and Secret to Apideck
Maintain the Pro or Advisors subscription
Authorise the connection✓ (and supply the Business ID)Handles the OAuth flow
Refresh tokens✓ Automatic
Build via the Unified APIMaintains connector
Monitor connections✓ Via Dashboard✓ Can revoke anytimeLogs & alerts

Environments

Single environment
Testing and production share one Wave host and one credential shape, because Wave runs no sandbox. To test: create a free Wave account and add as many test Businesses as you need — a Starter account exposes the same API surface as Pro — or request Apideck temporary shared test credentials at https://help.apideck.com/en/articles/7774658.
Signing up from outside North America
Set a VPN to the US or Canada and use an email address you have not tried before, then create the business as US-based with USD as its currency. Getting this wrong on the first attempt tags the address permanently, and no later attempt from that address succeeds. If you are already blocked, Wave can unblock addresses manually on request.
Caution
A test Business sits in the same Wave account as any real books you keep there, and the Business ID is the only thing separating them at connection time. Check which one you have connected before writing.

🚨Important to Know About Wave

  • A live connection can break with nothing changing on your side. If a connected business's Wave Pro or Advisors subscription lapses, the next token refresh returns 403 and the integration stops working until the subscription is reactivated.
  • Distributing your integration to other Wave businesses requires Wave's approval. Creating the application and testing it against your own account is self-service, but Wave's Permitted Use policy covers any integration that is not direct-to-your-own-business.
  • Wave serves the US and Canada only, and signup from elsewhere is geo-blocked. The block sticks to the email address on the first failed attempt, so a European team cannot simply retry behind a VPN.
  • Connecting is not purely one-click. Alongside the OAuth authorisation, each consumer must supply their Wave Business ID — a base64 string taken from the business's Wave app URL — so your onboarding needs a step that tells them where to find it.
📦

11 supported resources

View field mappings, supported operations, and schema details