# n8n

<img src={n8nLogoLight} alt="n8n" class="logo-light integration-logo" />
<img src={n8nLogoDark} alt="n8n" class="logo-dark integration-logo" />

## Overview

[n8n](https://n8n.io) is an open-source workflow automation platform that gives you full control over your data and processes. You can self-host it or use the cloud version, and extend it with code when no-code isn't enough.

The Altoviz node for n8n provides **52 operations** across all major Altoviz entities, letting you automate invoicing, customer management, expense tracking, and more directly from your n8n workflows.

👉 [View the Altoviz integration on n8n](https://n8n.io/integrations/altoviz/)

## Getting started

The Altoviz node is a **community node**. To install it:

1. In your n8n instance, go to **Settings → Community Nodes**.
2. Search for `n8n-nodes-altoviz` and click **Install**.
3. Add the Altoviz node to a workflow and create a new credential using your Altoviz API key.

You can generate an API key from your Altoviz account settings. See [Authentication](/docs/guides/authentication) for details.

## Operations

### Customers & Contacts

| Entity          | Available operations                                                      |
| --------------- | ------------------------------------------------------------------------- |
| Customer        | Create, Get, Get by internal ID, Update, Delete, Find, List, Get contacts |
| Contact         | Create, Get, Update, Delete, Find, List                                   |
| Customer Family | Create, Get, Delete, Find, List                                           |
| Colleague       | Create, Get, Get by internal ID, Update, Delete, Find, List               |

### Products & Catalog

| Entity         | Available operations                    |
| -------------- | --------------------------------------- |
| Product        | Create, Get, Update, Delete, Find, List |
| Product Family | Create, Get, Delete, List               |
| Product Image  | Get, Upload/Update, Delete              |

### Sales Documents

| Entity        | Available operations                                                                                               |
| ------------- | ------------------------------------------------------------------------------------------------------------------ |
| Sales Invoice | Create draft, Get, Update draft, Delete draft, Finalize, Send by email, Download PDF, Mark as paid, Find, List     |
| Sales Quote   | Create, Get, Delete, Send by email, Download PDF, Find, List                                                       |
| Sales Credit  | Create draft, Get, Update draft, Delete draft, Finalize, Send by email, Download PDF, Mark as refunded, Find, List |

### Suppliers & Expenses

| Entity           | Available operations                                                      |
| ---------------- | ------------------------------------------------------------------------- |
| Supplier         | Create, Get, Get by internal ID, Update, Delete, Find, List, Get contacts |
| Receipt          | Create, Get, Update, Delete, Find, List                                   |
| Purchase Invoice | Create from file                                                          |

### Reference Data

| Entity         | Available operations           |
| -------------- | ------------------------------ |
| Classification | List all                       |
| Unit           | List all                       |
| VAT            | List all VAT rates             |
| Settings       | Get account settings           |
| User           | Get current authenticated user |
| Bank Account   | List providers                 |

## Webhooks

Instead of polling-based triggers, the Altoviz n8n node lets you manage webhooks directly from your workflows:

- **Register a webhook** — subscribe to Altoviz events (invoice created, customer updated, etc.)
- **Unregister a webhook** — remove an existing subscription
- **List webhooks** — view all active webhook subscriptions

Use the n8n [Webhook node](https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.webhook/) alongside the Altoviz webhook operations to build event-driven workflows.

## Use cases

- **CRM to invoice** — When a deal closes in Hubspot or Pipedrive, create the customer and a draft sales invoice in Altoviz automatically.
- **Google Contacts sync** — Mirror your Altoviz customer list to Google Contacts so client info is always available on your phone.
- **Real-time reporting** — Push finalized invoices to Google Sheets or Notion for dashboards and financial tracking.
- **Expense automation** — Forward email receipts to n8n and automatically create receipts in Altoviz using the AI node to extract amounts and vendors.