API-Tokens und REST-API

Inhaber und Unternehmensadmin öffnen Unternehmensadmin → Vertrieb & Integrationen → Integrationen → API und Webhooks. Verbinden Sie Ihre Website, Ihr ERP oder andere Tools: Kontakte, Leads und Deals über eine REST-API lesen und schreiben und Ereignisse an Ihre Systeme senden lassen.

#Token erstellen

1. Wählen Sie unter API-Tokens Neues Token.
2. Geben Sie einen Name ein, zum Beispiel das System, das es nutzt.
3. Wählen Sie unter Handelt als, in wessen Namen Änderungen erfolgen: - Das Unternehmen: Änderungen zeigen keine Person. Funktioniert weiter, wenn Personen das Unternehmen verlassen. - Ich: Änderungen zeigen Ihren Namen. Funktioniert nicht mehr, wenn Sie Ihre Admin-Rechte verlieren.
4. Haken Sie unter Berechtigungen an, was das andere System braucht, etwa Kontakte · lesen oder Kontakte · schreiben. „Schreiben“ schließt „Lesen“ ein. Geben Sie nur, was das andere System benötigt.
5. Wählen Sie, wann es Läuft ab, und dann Token erstellen.
6. Kopieren Sie das Token und wählen Sie Gespeichert. Das Token wird nur dieses eine Mal angezeigt. Speichern Sie es in den geheimen Einstellungen Ihres anderen Systems. Senden Sie es als: Authorization: Bearer <token>

Erstellen Sie für jedes System ein eigenes Token, damit Sie sie einzeln entziehen können.

#Die API verwenden

Wählen Sie API-Dokumentation für Endpunkte, Felder und Beispiele. Die API umfasst Kontakte, Leads, Deals und Unternehmen: auflisten, lesen, anlegen und ändern. Löschen ist nicht möglich.

• Listen liefern bis zu 50 Einträge pro Seite (mit limit höchstens 100) und einen nextCursor für die nächste Seite.
• Jedes Token darf 120 Anfragen pro Minute stellen. Darüber antwortet die API mit 429 und einem Retry-After-Header.
• Jede Änderung über ein Token wird mit dem Namen des Tokens im Audit-Log festgehalten.

#Token entziehen

Wählen Sie neben dem Token Entziehen. Systeme, die dieses Token verwenden, funktionieren sofort nicht mehr. Bei jedem Token sehen Sie, wann es zuletzt verwendet wurde, so erkennen Sie nicht mehr benötigte Tokens.