Wave Accounting

Making Requests

All requests are POST to the GraphQL endpoint:

curl -s -X POST "https://gql.waveapps.com/graphql/public" \
  -H "Authorization: Bearer ${WAVE_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{"query": "...", "variables": {}}'

Always use ${WAVE_TOKEN} — loaded automatically from the shell profile.

Available Queries

Business & User

query {
  user { id defaultEmail }
  businesses(page: 1, pageSize: 10) {
    edges { node { id name currency { code } } }
  }
}

Customers

query($businessId: ID!) {
  business(id: $businessId) {
    customers(page: 1, pageSize: 50) {
      edges { node { id name email } }
    }
  }
}

Invoices

query($businessId: ID!, $page: Int!) {
  business(id: $businessId) {
    invoices(page: $page, pageSize: 50) {
      edges {
        node {
          id
          invoiceNumber
          title
          status
          invoiceDate
          dueDate
          amountDue { value currency { code } }
          amountPaid { value }
          customer { name email }
        }
      }
    }
  }
}

Transactions

query($businessId: ID!) {
  business(id: $businessId) {
    transactions(
      page: 1
      pageSize: 100
      filters: { startDate: "2026-02-01", endDate: "2026-02-28" }
    ) {
      edges {
        node {
          id
          date
          description
          amount
          account { name }
        }
      }
    }
  }
}

Accounts (Chart of Accounts)

query($businessId: ID!) {
  business(id: $businessId) {
    accounts(page: 1, pageSize: 100) {
      edges { node { id name type { value } subtype { value } } }
    }
  }
}

Available Mutations

Create Invoice

mutation($input: InvoiceCreateInput!) {
  invoiceCreate(input: $input) {
    didSucceed
    inputErrors { message path code }
    invoice { id invoiceNumber status }
  }
}

Send Invoice

mutation($input: InvoiceSendInput!) {
  invoiceSend(input: $input) {
    didSucceed
    inputErrors { message path code }
  }
}

Create Transaction

mutation($input: MoneyTransactionCreateInput!) {
  moneyTransactionCreate(input: $input) {
    didSucceed
    inputErrors { message path code }
    transaction { id description amount }
  }
}

Customer Management

• customerCreate — create new customer
• customerPatch — update existing customer
• customerDelete — remove customer

API Limitations

• No transactions query — the Business type does not expose a transactions field. Bank/payment transactions cannot be fetched via the public API.
• No invoice payment recording — there is no mutation to mark an invoice as paid or assign a payment transaction to an invoice. This must be done in the Wave web UI.
• moneyTransactionCreate is BETA — only works if isClassicAccounting is false for the business, and does not link to invoices.
• Inline string arguments not allowed — all string arguments must be passed as GraphQL variables (not inline literals).

Safety Rules

• Read queries: safe to run freely
• Mutations (create/send invoice, create transaction): always show the full payload and get explicit approval before executing
• No deletes without explicit confirmation — deletions in accounting can affect financial records
• Pagination: always handle paginated results — Wave returns max 50-100 records per page

Common Workflows

Check outstanding invoices

1. Query businesses to confirm business ID
2. Query invoices filtered by status: UNPAID
3. Present list with amounts, due dates, customer names

Monthly revenue summary

1. Query invoices for the month, filter by status: PAID
2. Sum amountPaid by customer
3. Cross-reference with Toggl hours if running alongside lyra-hours

Record a payment / transaction

1. Query accounts to find the correct account IDs
2. Confirm transaction details with user
3. Execute moneyTransactionCreate mutation