Integrationen (REST)

Verbindungen zu Drittsystemen über Unified.to verwalten und Daten abrufen. Basis-Pfad: /v1/integrations · Auth: Bearer

Methode	Pfad	Zweck
GET	/v1/integrations	Verfügbare Integrationen (Unified.to)
GET	/v1/integrations/connections	Eigene aktive Verbindungen
POST	/v1/integrations/connect	Verbindungs-Flow starten
POST	/v1/integrations/callback	Verbindung nach OAuth finalisieren
GET	/v1/integrations/connections/{connectionId}	Verbindung abrufen
DELETE	/v1/integrations/connections/{connectionId}	Verbindung entfernen
GET	/v1/integrations/{connectionId}/{category}/{objectType}	Daten abrufen
POST	/v1/integrations/{connectionId}/passthrough	Roh-API-Call ans Drittsystem

Kategorien

category ist eine von: crm, ticketing, calendar, messaging, storage, task, ats, accounting, ecommerce, hr, enrichment, marketing.

Body — Verbindung starten (POST /v1/integrations/connect)

Feld	Typ	Pflicht	Beschreibung
integration_type	string	✅	Provider (z. B. hubspot, salesforce)
categories	string[] (aus Kategorien, min. 1)	✅	zu aktivierende Kategorien
redirect_url	string (URI)	–	Redirect nach Autorisierung
external_xref	string	–	externe Referenz-ID
scopes	string[]	–	optionale Scopes

Antwort: { url, connection_id } — Nutzer zur url schicken, danach mit connection_id finalisieren:

Body — finalisieren (POST /v1/integrations/callback)

Feld	Typ	Pflicht
connection_id	string	✅

Daten abrufen (GET /v1/integrations/{connectionId}/{category}/{objectType})

{objectType} z. B. contact, company, deal, ticket, event, file. Query: limit (1–100, default 50), offset, query, updated_gte (ISO).

curl "https://api.eu.liza.app/api/v1/integrations/CONN_ID/crm/contact?limit=20&query=acme" \
  -H "Authorization: Bearer DEIN_TOKEN"

Passthrough (POST /v1/integrations/{connectionId}/passthrough)

Feld	Typ	Pflicht	Beschreibung
method	enum GET|POST|PUT|PATCH|DELETE	✅	HTTP-Methode
path	string	✅	Pfad beim Drittsystem
data	object | null	–	Body/Query

Für alles, was die generischen Endpunkte nicht abdecken:

curl -X POST https://api.eu.liza.app/api/v1/integrations/CONN_ID/passthrough \
  -H "Authorization: Bearer DEIN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"method":"GET","path":"/crm/contacts","data":{}}'