Skip to content

Synqly solves the operational complexity of building and maintaining integrations across many services while keeping a consistent, unified developer experience.

Instead of writing custom code for every provider, your application integrates once with Synqly's unified APIs. Synqly handles translation, normalization, and provider-specific execution behind the scenes.

synqly data flow

Internally, Synqly introduces organizational, integration, and security models that ensure tenant isolation, secure authentication, and scalable integration management. Those models are the real foundation of the platform and understanding them makes everything else click.

Platform Overview

The Synqly platform is built around three connected layers. Each exists to solve a distinct architectural problem.

Organizational Model

Who owns what. Defines ownership, access control, and how customer data stays isolated across your entire deployment.

Integration Model

How things connect. Defines how external systems are wired up, configured, and made reusable across tenants.

Authentication Model

How access is controlled. Separates administrative authority from runtime execution using distinct token scopes.


Organizational Model

Who owns what. Defines ownership, access control, and how customer data stays isolated across your entire deployment.

represented by

belong to

Organization

Members

Integration Points

Accounts

Integrations

End Users

Your Tenants

represented by

belong to

Organization

Members

Integration Points

Accounts

Integrations

End Users

Your Tenants

At the root of this model is the Organization, which owns the resources required to operate an integration ecosystem, including Members, Integration Points, and Accounts. Accounts typically represent your customers or tenants, providing isolated environments where integrations can be configured and managed independently.

Understanding the Organizational Model is essential for understanding how Synqly approaches multi-tenancy, security, and resource ownership.

The following sections explore each concept in greater detail and explain how they work together to establish ownership boundaries.

Integration Model

How things connect. Defines how external systems are wired up, configured, and made reusable across your tenants.

unified interface

policy + config

Connector - Ticketing

Integration Point

Integration

Provider - Jira

Provider - ServiceNow

Provider - Zendesk

unified interface

policy + config

Connector - Ticketing

Integration Point

Integration

Provider - Jira

Provider - ServiceNow

Provider - Zendesk

At a high level, the model separates:

  • What your application integrates with (Connector)
  • How that integration is governed (Integration Point)
  • Which provider is actually connected (Integration)

This separation allows applications to integrate against a stable, unified interface while retaining the flexibility to connect different providers for different customers or environments.

The following sections explain each component of the Integration Model in detail. Start with the concept you're interested in, or read them in order to understand how integrations are built from the unified interface down to the provider connection

Authentication Model

How access is controlled. Separates administrative authority from runtime execution using distinct token scopes.

Synqly exposes two distinct API layers, and each requires a different kind of credential.

The Management APIs control how your integration system is structured — creating Accounts, configuring Integration Points, managing Members. The Connector APIs perform the actual work against external providers — fetching tickets, querying identity events, routing alerts.

These two layers carry fundamentally different levels of authority, and Synqly enforces that separation by design.

TokenAPI layerAuthority
Organization Access TokenManagement APIsBroad — operates across the entire Organization
Integration Access TokenConnector APIsNarrow — scoped to a single Integration

This separation is enforced at the platform level, not just by convention. A runtime Integration Access Token cannot perform administrative operations, and an Organization Access Token cannot call Connector APIs. Each token is strictly limited to the layer it was issued for. The result is least-privilege by default.


Putting It All Together

The complete Synqly model, from organizational structure through to runtime execution:

Organization

Members

Integration Points

Account

Integration

Provider

Organization

Members

Integration Points

Account

Integration

Provider

The typical integration lifecycle follows this sequence:

  1. Authenticate using an Organization Access Token
  2. Create an Account to represent a tenant in your system.
  3. Configure an Integration within that Account, referencing a Provider
  4. Generate an Integration Access Token scoped to that Integration
  5. Call Connector APIs using the Integration Access Token to interact with the Provider

Organization Access Token

Integration Access Token

Your Product

Management APIs

Connector APIs

Create Accounts & Integrations

Interact with Providers

Organization Access Token

Integration Access Token

Your Product

Management APIs

Connector APIs

Create Accounts & Integrations

Interact with Providers