{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"redocly_category":"Guides","type":"markdown"},"seo":{"title":"How Mosaic is organized","description":"Everything about Mosaic Journeys, SDKs, and APIs","siteUrl":"https://developer.transmitsecurity.com/"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"how-mosaic-is-organized","__idx":0},"children":["How Mosaic is organized"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Mosaic is a single, unified platform for identity, authentication, verification, and fraud prevention, built with an API-first approach. Before you write any code, it helps to understand how Mosaic tenants, environments, and apps fit together."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Three concepts define the boundaries you work within:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Tenant"]},": The top-level administrative and identity boundary. Mosaic maintains one unified record per real person at the tenant level, and everything else—apps, roles, journeys, and promotion—operates inside a tenant. Identity and fraud signals are centralized per tenant, which is what makes detection accurate and integrations simple."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Environment"]},": Where a tenant runs. Mosaic offers ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["production"]}," environments (in several regions) for live traffic, and a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["sandbox"]}," environment for development and testing."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["App"]},": A configuration boundary inside a tenant. You model your organization—subsidiaries, lines of business, markets, and channels—using apps, each with its own isolated user pool and set of journeys. In B2B scenarios, you also model the business entities that access an app as ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["organizations"]},", with their own members and roles."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The platform is designed to model complexity ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["inside"]}," a tenant, not by creating many tenants. Keep this in mind as you plan your setup: reach for apps, organizations, and roles before you reach for additional tenants."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Note"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Ready to build? Start by ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/user/create_new_application"},"children":["creating an application"]},". To plan how you develop, test, and promote your integration across environments, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/deployment/development_lifecycle"},"children":["Development lifecycle"]},"."]}]}]},"headings":[{"value":"How Mosaic is organized","id":"how-mosaic-is-organized","depth":1}],"frontmatter":{"markdown":{"toc":{"hide":true}},"seo":{"title":"How Mosaic is organized"}},"lastModified":"2026-09-09T12:45:32.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/deployment/how_mosaic_is_organized","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}