{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-guides/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Providers","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":"providers","__idx":0},"children":["Providers"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A Provider is a specific third-party platform that your customers use, such as Jira, ServiceNow,"," ","Okta, Slack, or AWS."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["While Connectors represent a business capability such as ticketing, identity, or messaging,"," ","Providers are the individual products that implement those capabilities. Each Provider exposes"," ","its own APIs, authentication requirements, data models, and operational behavior."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"why-providers-matter","__idx":1},"children":["Why Providers Matter"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Providers are the systems where work ultimately happens. A ticket is created in Jira or"," ","ServiceNow. A user is managed in Okta. A message is sent through Slack."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Although Providers within the same category often offer similar functionality, they differ"," ","significantly in how that functionality is exposed:"]},{"$$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":"What varies"},"children":["What varies"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Examples"},"children":["Examples"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Authentication"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["OAuth 2.0, API keys, service accounts, SAML"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API structure"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["REST, GraphQL, SOAP, or proprietary conventions"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Rate limits"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Throttling policies differ widely across providers"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Pagination"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Cursor-based, offset-based, or token-based"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Resource schemas"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Field names, types, and relationships vary per provider"]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"The benefits of abstraction"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Without an abstraction layer, applications would need to understand and accommodate these"," ","differences for every supported Provider. Synqly handles this so your application never has to."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"providers-and-connectors","__idx":2},"children":["Providers and Connectors"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The relationship between Connectors and Providers is central to the Synqly model."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A Connector defines a common interface for a category of functionality, while Providers are the"," ","underlying implementations of that functionality."]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","diagramType":"mermaid","diagramSource":"flowchart TD\n conn(Ticketing Connector)\n jira(Jira)\n snow(ServiceNow)\n zen(Zendesk)\n\n conn --> jira & snow & zen\n","diagramHtml":"

Ticketing Connector

Jira

ServiceNow

Zendesk

","diagramHtmlDark":"

Ticketing Connector

Jira

ServiceNow

Zendesk

"},"children":["flowchart TD\n conn(Ticketing Connector)\n jira(Jira)\n snow(ServiceNow)\n zen(Zendesk)\n\n conn --> jira & snow & zen\n"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Your application never talks directly to a Provider"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Your application interacts with the Connector, not directly with individual Providers. Synqly translates requests between the Connector's unified model and each Provider's native implementation, insulating your application from provider-specific APIs and changes over time."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Reuse integration logic across Providers"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When integrating with Synqly, your application integrates with a Connector rather than individual Providers. This allows much of the same integration logic to be reused across Providers within the same Connector category, reducing the amount of provider-specific code you need to maintain."]}]}]},"headings":[{"value":"Providers","id":"providers","depth":1},{"value":"Why Providers Matter","id":"why-providers-matter","depth":2},{"value":"Providers and Connectors","id":"providers-and-connectors","depth":2}],"frontmatter":{"slug":"guides/concepts/providers","seo":{"title":"Providers"}},"lastModified":"2026-07-02T06:20:08.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/concepts/providers","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}