# Moneybird OAuth Credentials Setup

## Prerequisites

- A Moneybird account (sign up at [moneybird.com](https://www.moneybird.com))

## Steps

1. Log in to your Moneybird account
2. Navigate to **User Settings** → **Developer** → [**Applications**](https://moneybird.com/user/applications)
3. Click **New Application**
4. Fill in the application details:
   - **Name**: Your application name (e.g., "Your Company - Unify")
   - **Redirect URI**: `https://unify.apideck.com/vault/callback`
5. Click **Create Application**
6. Copy the **Client ID** and **Client Secret**

## Scopes

Moneybird uses scope-based access control. Request the following scopes:

| Scope | Access |
|-------|--------|
| `sales_invoices` | Sales invoices, contacts |
| `documents` | Purchase invoices, receipts, general documents |
| `bank` | Bank accounts, financial statements |
| `settings` | Administration settings, ledger accounts |

## Notes

- Moneybird OAuth tokens expire after 1 hour and are refreshed automatically
- The redirect URI must match exactly — including protocol and trailing slash
- For local development, register a separate app with `https://localhost:3050/vault/callback`