# 1Tool API

> REST API of 1Tool, a business software for CRM, quotes, invoices, projects, tasks, time tracking and more, at https://api.1tool.cloud/v1. Authenticate with a bearer token, read lists page by page. Each resource below has its own small OpenAPI file: load the one you need instead of the full specification.

- Every operation has a stable `operationId` such as `contacts.list` or `invoices.send`.
- An unknown filter is rejected with the allowed names; an unknown sort is ignored and named in the `X-Ignored-Sort` response header.
- Read and follow the getting-started guide before the first call: authentication, paging, limits, dates, custom fields.

## Getting started

- [Getting started](https://api.1tool.cloud/v1/public/docs.md?lang=de): authentication, headers, paging, filters, sorting, rate limits, dates, custom fields
- [Full OpenAPI specification](https://api.1tool.cloud/v1/public/openapi?lang=de): every operation in one file (several MB)
- [Interactive reference](https://api.1tool.cloud/v1/public/docs?lang=de)

## Anmeldung und Konto

- [Anmeldung](https://api.1tool.cloud/v1/public/openapi/auth?lang=de): Anmeldung per Passwort, SMS, Einmalcode oder Magic Link für Benutzer und Kontakte. Liefert den Bearer-Token für alle weiteren Aufrufe (17 operations)
- [Zwei-Faktor-Anmeldung](https://api.1tool.cloud/v1/public/openapi/two-factor?lang=de): Zweiten Faktor (App-Code) einrichten, bestätigen und zurücksetzen (7 operations)
- [Sitzungen und Geräte](https://api.1tool.cloud/v1/public/openapi/sessions?lang=de): Angemeldete Sitzungen und registrierte Geräte (z. B. für Push-Nachrichten) einsehen und beenden (10 operations)

## Kontakte

- [Kontaktgruppen](https://api.1tool.cloud/v1/public/openapi/contact-groups?lang=de): Kontakte in Gruppen ordnen (z. B. Kunden, Lieferanten, Newsletter) und regeln, wer welche Gruppe sehen darf (20 operations)
- [Beziehungen zwischen Kontakten](https://api.1tool.cloud/v1/public/openapi/contact-relations?lang=de): Verknüpfungen wie Firma und Ansprechpartner, Mutter- und Tochtergesellschaft (15 operations)
- [Notizen und Kommentare](https://api.1tool.cloud/v1/public/openapi/notes?lang=de): Notizen und Kommentare zu Kontakten, Projekten und anderen Datensätzen, mit Kategorien und Schlagwörtern (41 operations)
- [Besuche](https://api.1tool.cloud/v1/public/openapi/visits?lang=de): Besuchsberichte bei Kontakten, inklusive der dabei besprochenen oder verkauften Produkte (17 operations)
- [Kontakte](https://api.1tool.cloud/v1/public/openapi/contacts?lang=de): Kontakte anlegen, suchen, ändern und zusammenführen, mit Adressen, Anreden, Branchen und Einstellungen (167 operations)

## Vertrieb

- [Verkaufschancen](https://api.1tool.cloud/v1/public/openapi/opportunities?lang=de): Mögliche Aufträge mit Phase, Wert, Wahrscheinlichkeit, beteiligten Kontakten und Produkten (37 operations)
- [Leads](https://api.1tool.cloud/v1/public/openapi/leads?lang=de): Lead-Phasen, Pipeline-Status und Lead-Kosten pro Kontakt (23 operations)
- [Angebote](https://api.1tool.cloud/v1/public/openapi/proposals?lang=de): Angebote erstellen, mit Positionen, Texten, Status und Phasen, und in Rechnungen überführen (123 operations)
- [Verkaufsphasen und Ziele](https://api.1tool.cloud/v1/public/openapi/sales-control?lang=de): Verkaufsphasen, Kampagnen, Vertriebspartner, Umsatzziele und Freigaben nach Preisgrenzen (39 operations)

## Projekte und Aufgaben

- [Projekte](https://api.1tool.cloud/v1/public/openapi/projects?lang=de): Projekte anlegen und verwalten: Typen, Phasen, Mitglieder, Kostenstellen, Produkte und Vorlagen (94 operations)
- [Aufgaben](https://api.1tool.cloud/v1/public/openapi/tasks?lang=de): Aufgaben mit Status, Priorität, Kategorie, Typ und Checklisten (53 operations)
- [Boards](https://api.1tool.cloud/v1/public/openapi/boards?lang=de): Kanban-Boards mit Spalten (Phasen), Karten und Notizen (33 operations)
- [Ressourcenplanung](https://api.1tool.cloud/v1/public/openapi/resource-planning?lang=de): Mitarbeiter auf Projekte und Tage einplanen (61 operations)

## Zeit und Personal

- [Zeiterfassung](https://api.1tool.cloud/v1/public/openapi/time-tracking?lang=de): Arbeitszeiten und Tätigkeiten erfassen, auswerten und abrechnen (51 operations)
- [Urlaub und Abwesenheiten](https://api.1tool.cloud/v1/public/openapi/vacation?lang=de): Urlaubsanträge stellen, genehmigen und auswerten (12 operations)
- [Arbeitszeiten und Löhne](https://api.1tool.cloud/v1/public/openapi/working-hours?lang=de): Soll-Arbeitszeiten, Ausnahmen, Schichten, Beschäftigungsarten, Kollektivverträge und Zulagen (35 operations)
- [Stellen und Bewerbungen](https://api.1tool.cloud/v1/public/openapi/jobs?lang=de): Stellenausschreibungen, Bewerbungen und Bewerberstatus (31 operations)
- [Lernen](https://api.1tool.cloud/v1/public/openapi/learning?lang=de): Lernkurse, Zuweisungen an Mitarbeiter und Ergebnisse (31 operations)

## Kalender, Kurse und Umfragen

- [Termine](https://api.1tool.cloud/v1/public/openapi/calendar-events?lang=de): Termine mit Teilnehmern, Einladungen, Status, Räumen, Produkten und Verrechnung (111 operations)
- [Kurse und Seminare](https://api.1tool.cloud/v1/public/openapi/courses?lang=de): Kurse, Kurstermine, Teilnehmer, Kosten, Stornobedingungen, Online-Buchung und Trainerleistungen (58 operations)
- [Zertifikate](https://api.1tool.cloud/v1/public/openapi/certificates?lang=de): Zertifikate und Nachweise mit Typen, Untertypen und Merkmalen (30 operations)
- [Raumbuchung](https://api.1tool.cloud/v1/public/openapi/booking?lang=de): Räume, Raumkategorien, Standorte und Buchungsfelder (24 operations)
- [Umfragen](https://api.1tool.cloud/v1/public/openapi/surveys?lang=de): Fragebögen mit Fragen und Antworten, auch je Kontakt oder Projekt (34 operations)

## Finanzen

- [Rechnungen](https://api.1tool.cloud/v1/public/openapi/invoices?lang=de): Ausgangsrechnungen erstellen, versenden und stornieren, mit Positionen, Teilzahlungen, Texten, Mahnstufen und Zahlungszielen (109 operations)
- [Eingangsrechnungen und Kosten](https://api.1tool.cloud/v1/public/openapi/costs?lang=de): Eingangsrechnungen, Fixkosten und deren Zuordnung zu Kostenstellen und Kostenträgern (72 operations)
- [Fixeinnahmen](https://api.1tool.cloud/v1/public/openapi/income?lang=de): Wiederkehrende Einnahmen wie Abos und Wartungsverträge (9 operations)
- [Buchhaltung](https://api.1tool.cloud/v1/public/openapi/accounting?lang=de): Konten, Buchungen, Buchungsregeln, Steuercodes und BMD-Export (42 operations)
- [Bank und Zahlungsverkehr](https://api.1tool.cloud/v1/public/openapi/banking?lang=de): Bankkonten, SEPA-Dateien, Kontoabgleich über finAPI, Währungen und Wechselkurse (29 operations)
- [Budgets](https://api.1tool.cloud/v1/public/openapi/budgets?lang=de): Budgets mit Gruppen, Zeilen und Planwerten (22 operations)

## Produkte, Shop und Lager

- [Bestellungen](https://api.1tool.cloud/v1/public/openapi/orders?lang=de): Produktbestellungen von Kontakten (8 operations)
- [Produkte](https://api.1tool.cloud/v1/public/openapi/products?lang=de): Produkte mit Gruppen, Varianten, Einheiten, Preisen, Rabattstaffeln und Spezifikationen (119 operations)
- [Onlineshop](https://api.1tool.cloud/v1/public/openapi/shop?lang=de): Shop-Bestellungen, Gutscheine, Zahlungsarten, Optionen, Seiten und Vorlagen des Onlineshops (94 operations)
- [Lager](https://api.1tool.cloud/v1/public/openapi/warehouse?lang=de): Lagerorte, Bestände, Lieferanten, Ein- und Ausgänge und Inventur (65 operations)

## Kommunikation

- [E-Mail](https://api.1tool.cloud/v1/public/openapi/email?lang=de): E-Mails senden, Postfächer, Signaturen, Absender-Einstellungen und Ticket-Erkennung aus Mails (55 operations)
- [Newsletter](https://api.1tool.cloud/v1/public/openapi/newsletter?lang=de): Newsletter-Kampagnen, Verteiler, Abmeldungen und Mailchimp-Abgleich (41 operations)
- [Chat](https://api.1tool.cloud/v1/public/openapi/chat?lang=de): Chat-Nachrichten, Anhänge und automatische Übersetzung (21 operations)
- [Telefonie und SMS](https://api.1tool.cloud/v1/public/openapi/phone?lang=de): Telefonnummern, Anrufe und SMS-Versand (15 operations)
- [Benachrichtigungen](https://api.1tool.cloud/v1/public/openapi/notifications?lang=de): Benachrichtigungen in der App und Push-Nachrichten an Geräte (8 operations)

## Dateien und Dokumente

- [Dateien und Ordner](https://api.1tool.cloud/v1/public/openapi/files?lang=de): Dateien hochladen, ablegen, freigeben, wiederherstellen, als ZIP laden, mit OneDrive und SharePoint abgleichen (69 operations)
- [PDF, Excel und Vorlagen](https://api.1tool.cloud/v1/public/openapi/documents?lang=de): PDFs und Excel-Dateien erzeugen, PDF- und Word-Vorlagen, Layouts, Vorschauen für CAD und Videos (14 operations)

## Auswertungen

- [Berichte und Diagramme](https://api.1tool.cloud/v1/public/openapi/reports?lang=de): Berichte ausführen und exportieren, Ticket-Auswertungen, Diagramme und Statistiken (42 operations)
- [Listen](https://api.1tool.cloud/v1/public/openapi/lists?lang=de): Fertige Listenansichten mit Filtern und gespeicherten Listenvorlagen (51 operations)
- [Dashboard](https://api.1tool.cloud/v1/public/openapi/dashboard?lang=de): Widgets, Buttons, Schnellzugriffe, zuletzt geöffnete Datensätze und Aktivität (21 operations)

## Versicherung und Provisionen

- [Anträge](https://api.1tool.cloud/v1/public/openapi/insurance-applications?lang=de): Versicherungsanträge mit Produkten, Stornos, Importen und Provisionen (126 operations)
- [Versicherungsprodukte](https://api.1tool.cloud/v1/public/openapi/insurance-products?lang=de): Produkte, Eigenschaften, Sparten und automatische Zuordnung (63 operations)
- [Provisionen](https://api.1tool.cloud/v1/public/openapi/commissions?lang=de): Provisionsregeln, -empfänger, -abrechnungen, Boni und Stornohaftung (109 operations)
- [Schäden](https://api.1tool.cloud/v1/public/openapi/damages?lang=de): Schadensmeldungen mit Typ und Status (23 operations)
- [Regeln und KI-Auswertung](https://api.1tool.cloud/v1/public/openapi/insurance-rules?lang=de): Regelgruppen für Rechte und Zuordnung, KI-Auswertung von Dokumenten (26 operations)

## Verwaltung und Einstellungen

- [Benutzer und Rechte](https://api.1tool.cloud/v1/public/openapi/users?lang=de): Benutzer, Rollen, Berechtigungen, Abteilungen und persönliche Einstellungen (71 operations)
- [Eigene Felder und Masken](https://api.1tool.cloud/v1/public/openapi/custom-fields?lang=de): Mandantenspezifische Felder, Eingabemasken und deren Aufbau (62 operations)
- [Workflows, Prozesse und Webhooks](https://api.1tool.cloud/v1/public/openapi/workflows?lang=de): Automatische Abläufe mit Auslösern, Schritten und Aktionen, dokumentierte Prozesse und Webhooks an andere Systeme (55 operations)
- [Mandant und Einstellungen](https://api.1tool.cloud/v1/public/openapi/tenant?lang=de): Einstellungen und Variablen des Mandanten, Module, Menü, Gebiete, App-Einstellungen und Inhalte (144 operations)
- [KI](https://api.1tool.cloud/v1/public/openapi/ai?lang=de): KI-Anfragen sowie gespeicherte Prompts und Rezepte für den MCP-Connector (15 operations)
- [System](https://api.1tool.cloud/v1/public/openapi/system?lang=de): Warteschlange, Protokoll, Feedback und Wartung. Für die meisten Integrationen nicht nötig (5 operations)

## Nachschlagedaten und Hilfsdienste

- [Geokodierung](https://api.1tool.cloud/v1/public/openapi/geocoding?lang=de): Adressen in Koordinaten umwandeln und umgekehrt (11 operations)
- [Suche](https://api.1tool.cloud/v1/public/openapi/search?lang=de): Schnellsuche über Kontakte und andere Datensätze (6 operations)
- [Länder, Sprachen, Vorwahlen](https://api.1tool.cloud/v1/public/openapi/lookups?lang=de): Feste Auswahllisten, die andere Endpunkte als Werte erwarten (5 operations)

## Customer portal API (contact tokens): Anmeldung und Konto

- [Anmeldung](https://api.1tool.cloud/v1/portal/openapi/auth?lang=de): Anmeldung per Passwort, SMS, Einmalcode oder Magic Link für Benutzer und Kontakte. Liefert den Bearer-Token für alle weiteren Aufrufe (1 operations)
- [Sitzungen und Geräte](https://api.1tool.cloud/v1/portal/openapi/sessions?lang=de): Angemeldete Sitzungen und registrierte Geräte (z. B. für Push-Nachrichten) einsehen und beenden (3 operations)

## Customer portal API (contact tokens): Kontakte

- [Beziehungen zwischen Kontakten](https://api.1tool.cloud/v1/portal/openapi/contact-relations?lang=de): Verknüpfungen wie Firma und Ansprechpartner, Mutter- und Tochtergesellschaft (2 operations)
- [Notizen und Kommentare](https://api.1tool.cloud/v1/portal/openapi/notes?lang=de): Notizen und Kommentare zu Kontakten, Projekten und anderen Datensätzen, mit Kategorien und Schlagwörtern (7 operations)
- [Kontakte](https://api.1tool.cloud/v1/portal/openapi/contacts?lang=de): Kontakte anlegen, suchen, ändern und zusammenführen, mit Adressen, Anreden, Branchen und Einstellungen (28 operations)

## Customer portal API (contact tokens): Vertrieb

- [Angebote](https://api.1tool.cloud/v1/portal/openapi/proposals?lang=de): Angebote erstellen, mit Positionen, Texten, Status und Phasen, und in Rechnungen überführen (7 operations)

## Customer portal API (contact tokens): Projekte und Aufgaben

- [Projekte](https://api.1tool.cloud/v1/portal/openapi/projects?lang=de): Projekte anlegen und verwalten: Typen, Phasen, Mitglieder, Kostenstellen, Produkte und Vorlagen (8 operations)
- [Aufgaben](https://api.1tool.cloud/v1/portal/openapi/tasks?lang=de): Aufgaben mit Status, Priorität, Kategorie, Typ und Checklisten (21 operations)
- [Boards](https://api.1tool.cloud/v1/portal/openapi/boards?lang=de): Kanban-Boards mit Spalten (Phasen), Karten und Notizen (5 operations)

## Customer portal API (contact tokens): Zeit und Personal

- [Arbeitszeiten und Löhne](https://api.1tool.cloud/v1/portal/openapi/working-hours?lang=de): Soll-Arbeitszeiten, Ausnahmen, Schichten, Beschäftigungsarten, Kollektivverträge und Zulagen (6 operations)
- [Stellen und Bewerbungen](https://api.1tool.cloud/v1/portal/openapi/jobs?lang=de): Stellenausschreibungen, Bewerbungen und Bewerberstatus (1 operations)

## Customer portal API (contact tokens): Kalender, Kurse und Umfragen

- [Termine](https://api.1tool.cloud/v1/portal/openapi/calendar-events?lang=de): Termine mit Teilnehmern, Einladungen, Status, Räumen, Produkten und Verrechnung (17 operations)
- [Kurse und Seminare](https://api.1tool.cloud/v1/portal/openapi/courses?lang=de): Kurse, Kurstermine, Teilnehmer, Kosten, Stornobedingungen, Online-Buchung und Trainerleistungen (12 operations)
- [Zertifikate](https://api.1tool.cloud/v1/portal/openapi/certificates?lang=de): Zertifikate und Nachweise mit Typen, Untertypen und Merkmalen (2 operations)
- [Umfragen](https://api.1tool.cloud/v1/portal/openapi/surveys?lang=de): Fragebögen mit Fragen und Antworten, auch je Kontakt oder Projekt (20 operations)

## Customer portal API (contact tokens): Finanzen

- [Rechnungen](https://api.1tool.cloud/v1/portal/openapi/invoices?lang=de): Ausgangsrechnungen erstellen, versenden und stornieren, mit Positionen, Teilzahlungen, Texten, Mahnstufen und Zahlungszielen (4 operations)
- [Eingangsrechnungen und Kosten](https://api.1tool.cloud/v1/portal/openapi/costs?lang=de): Eingangsrechnungen, Fixkosten und deren Zuordnung zu Kostenstellen und Kostenträgern (5 operations)

## Customer portal API (contact tokens): Produkte, Shop und Lager

- [Bestellungen](https://api.1tool.cloud/v1/portal/openapi/orders?lang=de): Produktbestellungen von Kontakten (2 operations)
- [Produkte](https://api.1tool.cloud/v1/portal/openapi/products?lang=de): Produkte mit Gruppen, Varianten, Einheiten, Preisen, Rabattstaffeln und Spezifikationen (6 operations)

## Customer portal API (contact tokens): Kommunikation

- [Newsletter](https://api.1tool.cloud/v1/portal/openapi/newsletter?lang=de): Newsletter-Kampagnen, Verteiler, Abmeldungen und Mailchimp-Abgleich (2 operations)
- [Chat](https://api.1tool.cloud/v1/portal/openapi/chat?lang=de): Chat-Nachrichten, Anhänge und automatische Übersetzung (12 operations)

## Customer portal API (contact tokens): Dateien und Dokumente

- [Dateien und Ordner](https://api.1tool.cloud/v1/portal/openapi/files?lang=de): Dateien hochladen, ablegen, freigeben, wiederherstellen, als ZIP laden, mit OneDrive und SharePoint abgleichen (21 operations)
- [PDF, Excel und Vorlagen](https://api.1tool.cloud/v1/portal/openapi/documents?lang=de): PDFs und Excel-Dateien erzeugen, PDF- und Word-Vorlagen, Layouts, Vorschauen für CAD und Videos (3 operations)

## Customer portal API (contact tokens): Auswertungen

- [Berichte und Diagramme](https://api.1tool.cloud/v1/portal/openapi/reports?lang=de): Berichte ausführen und exportieren, Ticket-Auswertungen, Diagramme und Statistiken (1 operations)
- [Listen](https://api.1tool.cloud/v1/portal/openapi/lists?lang=de): Fertige Listenansichten mit Filtern und gespeicherten Listenvorlagen (1 operations)
- [Dashboard](https://api.1tool.cloud/v1/portal/openapi/dashboard?lang=de): Widgets, Buttons, Schnellzugriffe, zuletzt geöffnete Datensätze und Aktivität (1 operations)

## Customer portal API (contact tokens): Versicherung und Provisionen

- [Schäden](https://api.1tool.cloud/v1/portal/openapi/damages?lang=de): Schadensmeldungen mit Typ und Status (6 operations)

## Customer portal API (contact tokens): Verwaltung und Einstellungen

- [Benutzer und Rechte](https://api.1tool.cloud/v1/portal/openapi/users?lang=de): Benutzer, Rollen, Berechtigungen, Abteilungen und persönliche Einstellungen (3 operations)
- [Eigene Felder und Masken](https://api.1tool.cloud/v1/portal/openapi/custom-fields?lang=de): Mandantenspezifische Felder, Eingabemasken und deren Aufbau (11 operations)
- [Mandant und Einstellungen](https://api.1tool.cloud/v1/portal/openapi/tenant?lang=de): Einstellungen und Variablen des Mandanten, Module, Menü, Gebiete, App-Einstellungen und Inhalte (104 operations)
- [System](https://api.1tool.cloud/v1/portal/openapi/system?lang=de): Warteschlange, Protokoll, Feedback und Wartung. Für die meisten Integrationen nicht nötig (1 operations)

## Customer portal API (contact tokens): Nachschlagedaten und Hilfsdienste

- [Geokodierung](https://api.1tool.cloud/v1/portal/openapi/geocoding?lang=de): Adressen in Koordinaten umwandeln und umgekehrt (5 operations)
- [Länder, Sprachen, Vorwahlen](https://api.1tool.cloud/v1/portal/openapi/lookups?lang=de): Feste Auswahllisten, die andere Endpunkte als Werte erwarten (1 operations)

## Customer portal API (contact tokens): Weitere

- [Nicht zugeordnet](https://api.1tool.cloud/v1/portal/openapi/unsorted?lang=de): Noch keinem Bereich zugeordnet (11 operations)

## Optional

- [Classic Swagger view](https://api.1tool.cloud/v1/swagger/docs): the raw generated specification