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
| Task | You (Customer) | Your Consumer | Apideck |
|---|---|---|---|
| Create a Wave account | ✓ | — | — |
| Register the Wave application | ✓ | — | Docs 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 API | ✓ | — | Maintains connector |
| Monitor connections | ✓ Via Dashboard | ✓ Can revoke anytime | Logs & 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