{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-guides/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Organization","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":"organization","__idx":0},"children":["Organization"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Organization is the foundational container in Synqly. Every resource, configuration, integration, and identity ultimately belongs to an Organization."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["An Organization typically represents the company, product, or platform that is using Synqly. Everything created within Synqly including Accounts, Integration Points, Mappings, Members, Integrations, and related configuration is scoped to a single Organization."]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","diagramType":"mermaid","diagramSource":"flowchart TD\n org(Organization)\n mem(Members)\n acc(Accounts)\n ip(Integration Points)\n map(Mappings)\n int(Integrations)\n aud(Audit Data)\n\n org --> mem & acc & ip & map & aud\n acc --> int\n","diagramHtml":"

Organization

Members

Accounts

Integration Points

Mappings

Integrations

Audit Data

","diagramHtmlDark":"

Organization

Members

Accounts

Integration Points

Mappings

Integrations

Audit Data

"},"children":["flowchart TD\n org(Organization)\n mem(Members)\n acc(Accounts)\n ip(Integration Points)\n map(Mappings)\n int(Integrations)\n aud(Audit Data)\n\n org --> mem & acc & ip & map & aud\n acc --> int\n"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This hierarchy is more than a structural relationship. It reflects the platform's ownership model: resources do not exist independently, but as part of a larger integration system governed by an Organization."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"success","name":"The foundation"},"children":[" Understanding the Organization as the root of ownership, security, and administration provides the foundation for understanding every other concept in the Synqly data model. "]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"why-organizations-exist","__idx":1},"children":["Why Organizations Exist"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Organization model exists to answer a fundamental question: ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["who owns this integration ecosystem?"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Without an Organization boundary, resources such as Accounts, Integrations, and credentials would exist in a shared global space making it difficult to enforce security, manage permissions, track ownership, and isolate one customer's environment from another."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"The root of everything"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Every permission check, audit record, configuration decision, and integration ultimately traces back to an Organization. It is the root authority that owns all resources and establishes the scope within which administrative actions can occur."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"organizations-as-integration-systems","__idx":2},"children":["Organizations as Integration Systems"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A useful way to think about an Organization is as a complete integration system rather than"," ","merely a container of resources."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["An Organization contains everything required to manage integrations at scale:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Members who administer and operate the system"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Accounts that represent customers or isolation boundaries"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Integration Points that define reusable integration policies"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Mappings that customize data translation and behavior"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Integrations that connect external providers"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Credentials, tokens, and audit records that support secure operation"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Together, these resources form a self-contained integration environment."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"organizations-and-multi-tenancy","__idx":3},"children":["Organizations and Multi-Tenancy"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["One Organization can serve many applications, customers, and tenants."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For example, a SaaS platform may use a single Organization to manage integrations for hundreds"," ","or thousands of customer accounts. Each customer is isolated through Accounts, while the"," ","Organization provides the shared governance layer that manages those Accounts collectively."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This separation is intentional."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Owner vs. tenant"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Organization represents the owner and operator of the integration platform, while Accounts"," ","represent the individual customers, business units, or isolation boundaries within that platform."]}]}]},"headings":[{"value":"Organization","id":"organization","depth":1},{"value":"Why Organizations Exist","id":"why-organizations-exist","depth":3},{"value":"Organizations as Integration Systems","id":"organizations-as-integration-systems","depth":3},{"value":"Organizations and Multi-Tenancy","id":"organizations-and-multi-tenancy","depth":3}],"frontmatter":{"slug":"guides/concepts/organization","seo":{"title":"Organization"}},"lastModified":"2026-07-02T06:20:08.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/concepts/organization","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}