{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-guides/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["tabs","tab","admonition","cards","card"]},"type":"markdown"},"seo":{"title":"Connectors","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":1,"id":"connectors","__idx":0},"children":["Connectors"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A Connector is Synqly's abstraction layer for a category of integrations. It provides a unified"," ","API, common data model, and consistent operational behavior across multiple providers that solve"," ","the same business problem."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Connector"},"children":["Connector"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Example Providers"},"children":["Example Providers"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Identity"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Okta, Microsoft Entra ID, OneLogin"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Storage"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Amazon S3, Azure Blob Storage, Google Cloud Storage"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Messaging"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Slack, Microsoft Teams, PagerDuty"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Ticketing"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Jira, ServiceNow, Zendesk"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For a full list of supported Connectors and Providers, see the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://www.synqly.com/integration-partners/"},"children":["Integration Partners"]}," page."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Providers within the same category often deliver similar business capabilities, but each exposes"," ","different APIs, authentication methods, schemas, and operational behaviors. Without a common"," ","abstraction, applications must build and maintain separate integrations for every provider,"," ","increasing development and maintenance complexity as provider support expands."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"why-connectors-exist","__idx":1},"children":["Why Connectors Exist"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Connectors exist to decouple your application from provider-specific implementations."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Instead of integrating directly with Jira, ServiceNow, or Zendesk, your application integrates"," ","with the Ticketing Connector. Instead of learning the unique APIs of Okta and Microsoft Entra ID,"," ","your application works with the Identity Connector."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This shifts the integration model:"]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"TabItemFragment","attributes":{"label":"Before: Direct Integrations","disable":false},"children":[{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","diagramType":"mermaid","diagramSource":"flowchart TD\n app(Application)\n jira(Jira Integration)\n snow(ServiceNow Integration)\n zen(Zendesk Integration)\n\n app --> jira & snow & zen\n","diagramHtml":"

Application

Jira Integration

ServiceNow Integration

Zendesk Integration

","diagramHtmlDark":"

Application

Jira Integration

ServiceNow Integration

Zendesk Integration

"},"children":["flowchart TD\n app(Application)\n jira(Jira Integration)\n snow(ServiceNow Integration)\n zen(Zendesk Integration)\n\n app --> jira & snow & zen\n"]}]},{"$$mdtype":"Tag","name":"TabItemFragment","attributes":{"label":"After: With Connectors","disable":false},"children":[{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","diagramType":"mermaid","diagramSource":"flowchart TD\n app(Application)\n conn(Ticketing Connector)\n jira(Jira)\n snow(ServiceNow)\n zen(Zendesk)\n\n app --> conn\n conn --> jira & snow & zen\n","diagramHtml":"

Application

Ticketing Connector

Jira

ServiceNow

Zendesk

","diagramHtmlDark":"

Application

Ticketing Connector

Jira

ServiceNow

Zendesk

"},"children":["flowchart TD\n app(Application)\n conn(Ticketing Connector)\n jira(Jira)\n snow(ServiceNow)\n zen(Zendesk)\n\n app --> conn\n conn --> jira & snow & zen\n"]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"The Connector contract"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Connector becomes the stable contract your application depends on. Synqly manages every"," ","provider-specific implementation detail behind it so adding a new provider never requires"," ","changes to your application code."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"connectors-as-a-stability-layer","__idx":2},"children":["Connectors as a Stability Layer"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["One of the primary benefits of the Connector model is stability."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Provider APIs evolve over time. New providers are introduced. Existing providers change"," ","authentication methods, add capabilities, or modify their schemas. When applications integrate"," ","directly with providers, each of these changes lands on your engineering team."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Your code stays the same"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Connectors provide a stable interface that insulates your application from provider-specific"," ","change. You continue to call the same Connector API while Synqly absorbs the work of"," ","translating between your unified model and each provider's implementation."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"connectors-as-an-interoperability-layer","__idx":3},"children":["Connectors as an Interoperability Layer"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Connectors provide a shared model across providers within the same category, allowing your application to reuse much of its integration logic across multiple providers."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This can significantly reduce the amount of provider-specific code required when adding support for new providers."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Provider capabilities may vary"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["While Connectors provide a common interface, providers do not always support the same fields, filters, or operations. Synqly exposes provider capabilities so applications can understand what functionality is available."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"connectors-providers-and-integrations","__idx":4},"children":["Connectors, Providers, and Integrations"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A Connector defines ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["what can be done"]}," within a category. An Integration defines ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["which provider"," ","performs that work"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For example, an application may use the Ticketing Connector to create and retrieve tickets. One"," ","customer may configure an Integration to Jira, while another configures an Integration to"," ","ServiceNow. Both customers interact through the same Connector API, even though different"," ","providers execute the underlying operations."]},{"$$mdtype":"Tag","name":"Cards","attributes":{"columns":3,"cardMinWidth":240},"children":[{"$$mdtype":"Tag","name":"Card","attributes":{"title":"Connectors","imagePosition":"start","iconPosition":"auto","layout":"vertical","align":"start","variant":"filled"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Define the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["common interface"]}," — the API your application codes against."]}]},{"$$mdtype":"Tag","name":"Card","attributes":{"title":"Providers","imagePosition":"start","iconPosition":"auto","layout":"vertical","align":"start","variant":"filled"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Supply the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["underlying functionality"]}," — the platform that does the actual work."]}]},{"$$mdtype":"Tag","name":"Card","attributes":{"title":"Integrations","imagePosition":"start","iconPosition":"auto","layout":"vertical","align":"start","variant":"filled"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Connect ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["configuration, credentials, and an account"]}," to a specific provider."]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Together, these three concepts let your application support many providers through a single,"," ","stable integration surface."]}]},"headings":[{"value":"Connectors","id":"connectors","depth":1},{"value":"Why Connectors Exist","id":"why-connectors-exist","depth":2},{"value":"Connectors as a Stability Layer","id":"connectors-as-a-stability-layer","depth":2},{"value":"Connectors as an Interoperability Layer","id":"connectors-as-an-interoperability-layer","depth":2},{"value":"Connectors, Providers, and Integrations","id":"connectors-providers-and-integrations","depth":2}],"frontmatter":{"slug":"guides/concepts/connectors","seo":{"title":"Connectors"}},"lastModified":"2026-07-02T06:20:08.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/concepts/connectors","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}