API Keys

What an API key is

An API key is a secret code that identifies your account when you make requests to Finvo from your own software. It's like a password for machines.

When your code sends an invoice request to Finvo, it includes the API key to prove the request is authorized.

When you need one

You need an API key if you want to:

• • Generate invoices automatically from your own systems
• • Integrate Finvo with other tools (CRM, accounting software, etc.)
• • Build custom workflows without logging into the dashboard

If you create invoices through the Finvo website, you don't need an API key. The dashboard handles authentication differently.

How to generate a key

To create an API key:

1. Go to Settings → API Keys
2. Click "Generate New Key"
3. Copy the key immediately

The full key is only shown once. After you leave the page, you'll only see an obscured version. If you lose the key, you'll need to generate a new one.

How keys are used

When making API requests, include your key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

For complete examples and endpoint details, see the API documentation.

Keeping keys secure

Treat API keys like passwords:

• • Don't share keys publicly (avoid committing them to code repositories)
• • Store keys in environment variables, not in your source code
• • Use different keys for development and production if possible
• • Revoke keys immediately if you think they've been exposed

If a key is compromised, anyone with it can generate invoices as if they were you.

Current limitations

A few things to know about API keys in Finvo:

• • Account-level — Keys belong to your entire account, not individual users.
• • No scopes — All keys have the same permissions. There's no way to create a read-only key.

For detailed questions about API key management, see the API Keys Help page.