Moss

{/* Generated by scripts/generate-integration-catalog.mjs. Do not edit by hand. */}

At a glance

  • Availability: Experimental (how to enable).
  • Authentication: OAuth 2.0 (client credentials).
  • Connection: Veryfront obtains machine-to-machine tokens from the client ID and secret in the project's environment variables.
  • Provider documentation: Authentication reference.

Credentials

Set these per environment. See Connect an integration.

VariableRequiredDescription
MOSS_CLIENT_IDYesMoss API Key ID (starts with kid_), created by an admin under Settings > Platform > API Keys Docs.
MOSS_CLIENT_SECRETYesMoss API Secret Key (starts with sk_) paired with the Key ID Docs.

Setup

  1. 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.
  2. Set environment variables: Set MOSS_CLIENT_ID to the Key ID and MOSS_CLIENT_SECRET to the Secret Key.
  3. 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').

Provider notes

  • 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.

Provider API reference.

Tools

ToolAccessDescription
List Expenses<br /><code className="reference-identifier">moss__list_expenses</code>ReadList expenses
Search Bank Transactions<br /><code className="reference-identifier">moss__search_bank_transactions</code>ReadSearch bank transactions
List Bank Accounts<br /><code className="reference-identifier">moss__list_bank_accounts</code>ReadList bank accounts
Search Receipt Files<br /><code className="reference-identifier">moss__search_receipt_files</code>ReadSearch receipt files
List Expense Accounts<br /><code className="reference-identifier">moss__list_expense_accounts</code>ReadList expense accounts
List Suppliers<br /><code className="reference-identifier">moss__list_suppliers</code>ReadList suppliers
Get File Content<br /><code className="reference-identifier">moss__get_file_content</code>ReadDownload receipt file
Get Bank Account Balance<br /><code className="reference-identifier">moss__get_bank_account_balance</code>ReadGet bank account balance
List Tax Rates<br /><code className="reference-identifier">moss__list_tax_rates</code>ReadList tax rates

Verify the connection

Call a read tool such as moss__list_expenses with arguments for your account. Confirm that the result comes from the intended account or workspace before enabling write tools.