Moss

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/

Set these per environment. See Connect an integration.

Variable	Required	Description
`MOSS_CLIENT_ID`	Yes	Moss API Key ID (starts with kid_), created by an admin under Settings > Platform > API Keys Docs.
`MOSS_CLIENT_SECRET`	Yes	Moss API Secret Key (starts with sk_) paired with the Key ID Docs.

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.

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

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.