At a glance
- Availability: Experimental (how to enable).
- Auth: OAuth 2.0 (client credentials).
- Connection: Veryfront mints machine-to-machine tokens from the client ID and secret in the project’s environment variables.
- Docs: https://developers.getmoss.com/
Credentials
Set these per environment. See Connect an integration.Setup
- Create an API key: As a Moss admin, go to Settings > Platform > API Keys in the Moss app and create a key. You receive a Key ID (kid_…) and a Secret Key (sk_…). Only admins can create API keys.
- Set environment variables: Set MOSS_CLIENT_ID to the Key ID and MOSS_CLIENT_SECRET to the Secret Key.
- Verify access: Run List Bank Accounts or List Expenses. Access tokens are minted automatically via the OAuth2 client_credentials grant at https://public-api.getmoss.com/oauth2/token (valid for 1 hour, scope ‘read’).
- This connector requests the ‘read’ scope only; Moss write endpoints (creating suppliers, dimensions, or dimension items) require scope ‘write’ and are not included.
- Rate limits: 180 read requests/minute and 20 write requests/minute per company.
- The Search Bank Transactions and Search Receipt Files tools use POST search-query endpoints but are read-only.
Tools
| Tool | Access | Description |
|---|---|---|
| List Expenses | Read | List expenses - card transactions, invoices, and reimbursements - with status, export status, and date filters; the basis for accounting exports |
| Search Bank Transactions | Read | Search bank transactions of a Moss bank account within a booking-date window (read-only search query) |
| List Bank Accounts | Read | List the company’s bank accounts in Moss (use the IDs with Search Bank Transactions) |
| Search Receipt Files | Read | Find receipt and invoice files attached to specific expenses (read-only search query); download via the returned file IDs |
| List Expense Accounts | Read | List the chart of accounts used for ledger posting, for mapping expenses into your accounting system |
| List Suppliers | Read | List supplier master data for spend-by-vendor analysis and accounting export enrichment |
| Get File Content | Read | Download the binary content of a receipt or invoice file (application/octet-stream) using a file ID from Search Receipt Files |
| Get Bank Account Balance | Read | Get the current balance of a Moss bank account for liquidity overviews |
| List Tax Rates | Read | List VAT/tax rate master data for mapping expenses into the accounting system |
Example prompts
- List Moss expenses with export status READY_FOR_EXPORT and summarize them by type and supplier.
- Show this month’s Moss card transactions and break down spend by status.
- For my most recent approved Moss expenses, check which ones have receipt files attached.