Integrations (REST)

Manage connections to third-party systems via Unified.to and retrieve data. Base path: /v1/integrations · Auth: Bearer

Method	Path	Purpose
GET	/v1/integrations	Available integrations (Unified.to)
GET	/v1/integrations/connections	Your active connections
POST	/v1/integrations/connect	Start the connection flow
POST	/v1/integrations/callback	Finalize the connection after OAuth
GET	/v1/integrations/connections/{connectionId}	Retrieve a connection
DELETE	/v1/integrations/connections/{connectionId}	Remove a connection
GET	/v1/integrations/{connectionId}/{category}/{objectType}	Retrieve data
POST	/v1/integrations/{connectionId}/passthrough	Raw API call to the third-party system

Categories

category is one of: crm, ticketing, calendar, messaging, storage, task, ats, accounting, ecommerce, hr, enrichment, marketing.

Body — start a connection (POST /v1/integrations/connect)

Field	Type	Required	Description
integration_type	string	✅	Provider (e.g. hubspot, salesforce)
categories	string[] (from Categories, min. 1)	✅	Categories to activate
redirect_url	string (URI)	–	Redirect after authorization
external_xref	string	–	External reference ID
scopes	string[]	–	Optional scopes

Response: { url, connection_id } — send the user to url, then finalize with connection_id:

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

Field	Type	Required
connection_id	string	✅

Retrieve data (GET /v1/integrations/{connectionId}/{category}/{objectType})

{objectType} e.g. 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)

Field	Type	Required	Description
method	enum GET|POST|PUT|PATCH|DELETE	✅	HTTP method
path	string	✅	Path on the third-party system
data	object | null	–	Body/query

For anything the generic endpoints don't cover:

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":{}}'