{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-guides/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["img"]},"type":"markdown"},"seo":{"title":"Synqly Overview","siteUrl":"https://docs.synqly.com","lang":"en-US","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"overview","__idx":0},"children":["Overview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Synqly provides a simple, secure, and sustainable interface for integrating with third-party platforms, enabling you to connect once and immediately give your users access to multiple services."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["At the core of our integration platform lies a transformative abstraction layer that enables connections between cybersecurity and IT Operations solutions, via a unified API. This layer enables you to integrate with a diverse ecosystem of products to meet your customer's integration requirements."]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/synqly_data_flow.22cdbd2bedc6c26d6baa4a16ae25600e16d2587b71f945eabd505fc1a9634d08.5c9a700f.png","alt":"synqly data flow","withLightbox":false,"align":"center","style":{"marginTop":"15px","marginBottom":"15px"}},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"concepts","__idx":1},"children":["Concepts"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When working with Synqly you will come across some terminology that have specific meaning within the Synqly system:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Connector"]},": A unified API and data model for each category of providers (e.g., Messaging, Ticketing, Storage). Connectors offer a single interface for multiple providers in the same category."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Provider"]},": A specific third-party service within a Connector category, such as Jira or ServiceNow within the ticketing Connector. Synqly translates your requests to interact with the multitude of Providers supported within any given Connector category."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Account"]},": A group of integrations and associated resources, typically representing a customer or tenant in your system."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["End User"]},": The customer of your customer, someone who registers Integrations (e.g., connecting Jira to Synqly)."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"synqly-data-model","__idx":2},"children":["Synqly Data Model"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Understanding the Synqly data model ensures a smooth getting started experience. The diagram provides a high level overview of the models you will come across while working with Synqly."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"organization","__idx":3},"children":["Organization"]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","diagramType":"mermaid","diagramSource":"flowchart TD\n org(Organization)\n acc(Accounts)\n int(Integrations)\n key(Credentials)\n ips(Integration Points)\n usr(Members)\n map(Mappings)\n\n org --> acc --> int & key\n org --> ips & map & usr\n","diagramHtml":"

Organization

Accounts

Integrations

Credentials

Integration Points

Members

Mappings

","diagramHtmlDark":"

Organization

Accounts

Integrations

Credentials

Integration Points

Members

Mappings

"},"children":["flowchart TD\n org(Organization)\n acc(Accounts)\n int(Integrations)\n key(Credentials)\n ips(Integration Points)\n usr(Members)\n map(Mappings)\n\n org --> acc --> int & key\n org --> ips & map & usr\n"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["At the root of the Synqly data model is the Organization, which contains all other resources. An Organization represents a complete integration system, and may serve multiple applications and tenants."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The resources directly owned by an Organization are Accounts, Integration Points, Mappings, and Organization Members. These models are described in the following sections."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"accounts","__idx":4},"children":["Accounts"]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","diagramType":"mermaid","diagramSource":"flowchart TD\n acc(Accounts)\n int(Integrations)\n key(Credentials)\n\n acc --> int & key\n","diagramHtml":"

Accounts

Integrations

Credentials

","diagramHtmlDark":"

Accounts

Integrations

Credentials

"},"children":["flowchart TD\n acc(Accounts)\n int(Integrations)\n key(Credentials)\n\n acc --> int & key\n"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Within each Organization there may be any number of Accounts. They represent the owner of Integrations and will contain any associated data like configuration and Credentials."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Accounts are secure containers, meaning any data contained within is segregated from other Accounts to ensure data privacy. Because of this property Accounts are the main multi-tenancy primitive in the Synqly data model."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["We recommend that you create at least one Account per tenant in your system, but you may also create more or fewer Accounts, depending on your data segregation requirements."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Accounts contain Integrations and Credentials."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"integrations--credentials","__idx":5},"children":["Integrations & Credentials"]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","diagramType":"mermaid","diagramSource":"flowchart TD\n int(Integrations)\n key(Credentials)\n\n int o--o key\n","diagramHtml":"

Integrations

Credentials

","diagramHtmlDark":"

Integrations

Credentials

"},"children":["flowchart TD\n int(Integrations)\n key(Credentials)\n\n int o--o key\n"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["An Integration represents a connection to a specific Provider supported by Synqly. The connection is described by a collection of Provider specific properties, including Credentials."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Whenever calling a Connector operation, such as ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api-reference/connectors/identity/identity_query_audit_log"},"children":["Identity / Query Audit Log"]}," or ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api-reference/connectors/edr/edr_query_threatevents"},"children":["EDR / Query Threat Events"]},", you will be calling the operation using a specific Integration."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Integrations may be linked to Credentials, which represent specific configuration details that must be kept secret. This includes things such as OAuth Client Credentials, API keys, usernames and passwords etc."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Integrations may be linked to one or more Credentials, depending on the details of that Integration's configuration."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Credentials may be owned either by an Account, in which case it's considered a shared Credential that may be reused by multiple Integrations within the ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["same"]}," Account. It is ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["not"]}," possible for Integrations in different Accounts to share the same Credential."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Credentials may also be owned by an Integration, in which case no other Integration may share that Credential. This is the most typical and recommended approach to managing Credentials, as this ensures Synqly will remove any associated Credentials when an integration is removed."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"integration-points","__idx":6},"children":["Integration Points"]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","diagramType":"mermaid","diagramSource":"flowchart TD\n int(Integrations)\n ips(Integration Points)\n map(Mappings)\n\n ips o--o int & map\n","diagramHtml":"

Integrations

Integration Points

Mappings

","diagramHtmlDark":"

Integrations

Integration Points

Mappings

"},"children":["flowchart TD\n int(Integrations)\n ips(Integration Points)\n map(Mappings)\n\n ips o--o int & map\n"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Integration Points represent a group of Integrations, within a single Connector category. Integration Points may also be associated with supplemental resources such as Mappings, to enable consistent configuration across the Integrations in the group."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Integration Points also act as validators for any integrations added to the group. For example, an integration may declare that only specific Providers within that category should be supported, denying the creation of any Integrations that do not fit the specified requirements."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"mappings","__idx":7},"children":["Mappings"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Mappings are an advanced feature that allows you to customize the default data mapping implemented by Synqly. They can be used to either augment the existing mapping chains, or replace the data mappings entirely."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To read more about Mappings, please see our sections on ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api-reference/customer-defined-mappings"},"children":["customer defined mappings"]}," and ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api-reference/adaptive-mapping"},"children":["adaptive mapping"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"members","__idx":8},"children":["Members"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Members are users that have access to your Synqly Organization, either via the API, Management Console, or both. Typically this will be engineers or support personel in your team, but can also be services."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Synqly supports member accounts both for individuals as well as service accounts."]}]},"headings":[{"value":"Overview","id":"overview","depth":2},{"value":"Concepts","id":"concepts","depth":2},{"value":"Synqly Data Model","id":"synqly-data-model","depth":2},{"value":"Organization","id":"organization","depth":3},{"value":"Accounts","id":"accounts","depth":3},{"value":"Integrations & Credentials","id":"integrations--credentials","depth":3},{"value":"Integration Points","id":"integration-points","depth":3},{"value":"Mappings","id":"mappings","depth":3},{"value":"Members","id":"members","depth":3}],"frontmatter":{"slug":"guides/getting-started/overview-concepts","seo":{"title":"Synqly Overview"}},"lastModified":"2026-05-29T11:19:35.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/getting-started/overview-concepts","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}