From CRM to invoice
Create a client and turn a completed project into an invoice draft.
NORMAN DEVELOPERS
Build your workflows with Norman.
Build integrations with the Norman Public API. Explore invoices, transactions, document OCR, automation workflows and MCP connections.
API base URL
https://api.norman.finance/api/v1Quickstart →
Create a Norman account, get a company API key and make your first request with curl, Python or Node.js.
Authentication & data →
Authenticate with Bearer API keys, select company permissions, rotate credentials and understand Norman API amounts, dates and pagination.
Documents & OCR →
Upload receipts, follow batch OCR progress, inspect per-file errors, re-extract fields and import processed documents into Norman.
Invoicing workflows →
Sync products, extract invoice proposals from contracts, retrieve PDF and XML files, match payments and manage existing recurring series.
Integration recipes →
Adapt working Norman API requests for client creation, invoice drafts, receipt uploads, manual expenses and paginated transaction exports.
n8n, Make & MCP →
Build HTTP workflows with the Norman REST API or connect AI assistants through the hosted MCP server and Norman authorization.
API reference →
Browse supported Norman REST API operations, company scopes, query parameters, request fields and response schemas.
Errors & support →
Resolve Norman API authentication and validation errors, handle rate limits and write retries, and request integration support.
Get your API key in Norman
Create an account or log in, select your company, then open Automations → Integrations → Public API to create a key and choose its permissions.
What you can build
A document pipeline
Upload receipts and invoices, then read their processing results.
Your own reporting
Pull transactions into a spreadsheet, dashboard or internal tool.
| Resource | Coverage | Permissions |
|---|---|---|
| Companies | Find the company linked to your key and read its details. | Any valid company key |
| Transactions | Read and manage transactions, process document batches and attach supporting files. | read_transactions / write_transactions |
| Bank accounts | Read bank connections already linked to the company. | read_transactions |
| Clients | Manage clients and read payment statistics with invoice-read permission. | read_clients / write_clients |
| Invoices | Manage invoices, download PDF/XML, match payments, read contract proposals and send reminders. | read_invoices / write_invoices |
| Products | Sync, search and archive products and services for invoicing. | read_invoices / write_invoices |
| Recurring invoices | Read series, preview dates and stop future recurring invoices. | read_invoices / write_invoices |
| Documents | Upload, import without OCR, re-extract, correct metadata, preview, download and link documents. | read_documents / write_documents |
| Tax reports & settings | Read existing reports and tax settings for the company. | read_tax |
This reference defines the supported public operations. Payments, bank authorization, tax filing and internal automation controls remain in the Norman application. Account and plan requirements apply to API requests too.