{"templateId":"GuidePage","sharedDataIds":{"sidebar":"sidebar-miniapps/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Architecture","description":"Developer API, partner integration, MCP, SDK, and customer help center.","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":"architecture","__idx":0},"children":["Architecture"]},{"$$mdtype":"Tag","name":"Mermaid","attributes":{"data-language":"mermaid","diagramSource":"flowchart TB\n subgraph Platform[\"Karzoun platform\"]\n MP[Marketplace]\n AE[Automation engine]\n DB[Dashboard apps]\n MA[MiniApps runtime]\n DEF[(MiniApp definition)]\n MP --> MA\n AE --> MA\n DB --> MA\n DEF --> MA\n end\n\n subgraph Provider[\"Your service\"]\n API[REST / GraphQL API]\n WH[Webhook sender]\n end\n\n MA <-->|OAuth / API calls| API\n WH -->|POST /miniapps/ns/webhooks| MA\n","diagramHtml":"

Your service

Karzoun platform

OAuth / API calls

POST /miniapps/ns/webhooks

Marketplace

Automation engine

Dashboard apps

MiniApps runtime

MiniApp definition

REST / GraphQL API

Webhook sender

"},"children":["flowchart TB\n subgraph Platform[\"Karzoun platform\"]\n MP[Marketplace]\n AE[Automation engine]\n DB[Dashboard apps]\n MA[MiniApps runtime]\n DEF[(MiniApp definition)]\n MP --> MA\n AE --> MA\n DB --> MA\n DEF --> MA\n end\n\n subgraph Provider[\"Your service\"]\n API[REST / GraphQL API]\n WH[Webhook sender]\n end\n\n MA <-->|OAuth / API calls| API\n WH -->|POST /miniapps/ns/webhooks| MA\n"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A MiniApp is a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["single JSON document"]}," you author and submit to Karzoun. After review and approval, Karzoun hosts the definition and runs it at runtime. You do not deploy servers or databases on our infrastructure."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The document declares:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Authentication"]}," — How tenants connect accounts (OAuth 2.0 or API key)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Actions"]}," — API calls users and automations can run"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Triggers"]}," — Events that appear in the Automation Builder"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Webhooks"]}," — How inbound provider events are verified and parsed"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Sync"]}," (optional) — Bulk import and realtime commerce sync for e-commerce platforms"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Sources"]}," — RPC-backed dropdowns in action forms"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Karzoun interprets the document at runtime. Behavior is declared in JSON — no custom server code on your side."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"related-docs","__idx":1},"children":["Related docs"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/developers/guides/webhooks"},"children":["Tenant webhooks"]}," — Workspace-level outbound webhooks (separate from MiniApp inbound webhooks)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/partners"},"children":["Partners program"]}," — Whitelabel and embedded commerce integrations"]}]}]},"headings":[{"value":"Architecture","id":"architecture","depth":1},{"value":"Related docs","id":"related-docs","depth":2}],"frontmatter":{"title":"Architecture","titleTranslationKey":"sidebar.miniapps.architecture","audience":"developer","status":"published","locales":["en"],"template":"GuidePage","seo":{"title":"Architecture"}},"lastModified":"2026-06-23T12:06:12.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/miniapps/architecture","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}