Developers
Ein Endpunkt. Unendliche Möglichkeiten.
Die Nori GraphQL-API automatisiert jeden Ablauf: Rechnungen und Angebote erzeugen, Kunden und Zeiten synchronisieren, Nori an dein CRM oder ERP hängen.
- Rechnungen automatisiert erstellen
- Angebot → Rechnung per Aufruf
- Kunden & Zeiten synchronisieren
- An CRM/ERP anbinden
Request
query {
noriInvoices(status: "open") {
data { number due_date customer { name } }
}
}
Response
{
"data": {
"noriInvoices": {
"data": [
{ "number": "2026-0042",
"due_date": "2026-07-15",
"customer": { "name": "ACME GmbH" } }
]
}
}
}
API-Zugang
So bekommst du Zugang – in drei Schritten
Von null zur ersten authentifizierten Anfrage. Alles, was du dafür brauchst, in der richtigen Reihenfolge.
-
Team-Plan aktivieren
Der API-Zugang ist im Team-Plan enthalten. Steht dein Team auf einem kleineren Plan, wechselst du dafür auf Team.
-
Token erstellen
Öffne in Nori dein Profil und den Tab „API-Tokens". Erstelle einen persönlichen Token – er beginnt mit nori_ und wird nur einmal angezeigt. Kopiere ihn direkt.
-
Authentifizieren
Schick den Token als Bearer im Authorization-Header an den GraphQL-Endpunkt. Ab jetzt sprichst du mit der API – am schnellsten testest du das im Playground.
Dokumentation
Dein Einstieg in die Doku
Die vollständige API-Referenz ist dein fundamentaler Startpunkt – dazu die passenden Guides für den Einstieg.
API
Die Nori-API ist eine GraphQL-API – ein einziger Endpunkt, über den du genau die Daten abfragst und Aktionen auslöst, die du brauchst.
Beispiele
Die erste Anfrage
Authentifiziert wird per Bearer-Token (Präfix nori_) im Authorization-Header. Von der Verbindungsprüfung bis zum ersten Schreibzugriff.
curl https://api.noridocs.com/graphql \
-H "Authorization: Bearer nori_dein_token" \
-H "Content-Type: application/json" \
-d '{ "query": "{ noriPing }" }'
query {
noriInvoices(status: "open") {
data {
id
number
status
due_date
customer { name }
}
}
}
mutation {
noriCreateCustomer(input: {
name: "ACME GmbH"
tax_id: "ATU12345678"
city: "Wien"
}) {
id
customer_number
name
}
}
Was die API abdeckt
Diese Ressourcen kannst du lesen und schreiben
Jede Ressource ist über Scopes am Token einzeln abgesichert – der Token kann nur, was du ihm erlaubst.
Rechnungen
Rechnungen abfragen, nach Status filtern und neu anlegen. Scope: invoice.read / invoice.write.
Angebote
Angebote lesen, filtern und den Lebenszyklus automatisieren. Scope: proposal.read / proposal.write.
Kunden
Kunden und Ansprechpartner anlegen, suchen und aktualisieren. Scope: customer.read / customer.write.
Zeiterfassung
Zeiteinträge, Zeit-Streams und Kontingente abfragen. Scope: time_entry.read, time_stream.read.
Dokumente
Zusammengestellte Dokumente lesen und per Mutation erzeugen. Scope: document.read / document.write.
Produkte
Produkte und Leistungen abfragen und pflegen – als Basis für Positionen auf Angeboten und Rechnungen. Scope: product.read / product.write.
Live ausprobieren
Schema erkunden im Playground
Durchsuche das Schema, schreib Queries und Mutations und setz deinen Bearer-Token – live an der echten API.
Schema-Autovervollständigung? In Apollo Studio öffnen
Bereit loszulegen?
Aktiviere den Team-Plan, erzeuge deinen Token im Profil und schick die erste Query los.