{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-miniapps/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["callout"]},"type":"markdown"},"seo":{"title":"MiniApps","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":"miniapps","__idx":0},"children":["MiniApps"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["MiniApps are JSON integration definitions for the Karzoun Marketplace. You author the document, test against your provider's API, and ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/miniapps/guides/submission"},"children":["submit for review"]},". Karzoun hosts approved definitions — tenants install from Marketplace and connect their accounts."]},{"$$mdtype":"Tag","name":"Callout","attributes":{"type":"info","title":"Not self-hosted"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You do not deploy databases or seed scripts on Karzoun infrastructure. External developers deliver a definition + assets; Karzoun registers it after QA approval."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"start-here","__idx":1},"children":["Start here"]},{"$$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":"Guide"},"children":["Guide"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/miniapps/getting-started/quickstart"},"children":["Quickstart"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Minimal bearer-token MiniApp"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/miniapps/architecture"},"children":["Architecture"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Platform flow and components"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/miniapps/reference/document-schema"},"children":["Document schema"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Required JSON fields"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/miniapps/guides/submission"},"children":["Submit for review"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Submission package and approval process"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"core-concepts","__idx":2},"children":["Core concepts"]},{"$$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":"Guide"},"children":["Guide"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/miniapps/guides/authentication"},"children":["Authentication"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Bearer tokens, OAuth 2.0, registration"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/miniapps/guides/actions"},"children":["Actions"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Requests, parameters, chaining"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/miniapps/guides/dynamic-data-sources"},"children":["Dynamic data sources"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["RPC dropdowns"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/miniapps/guides/triggers"},"children":["Triggers"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Automation trigger nodes"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/miniapps/guides/webhooks"},"children":["Webhooks"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Inbound provider events"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/miniapps/guides/sync"},"children":["Sync"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Bulk import and commerce handlers"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/miniapps/guides/ecommerce"},"children":["E-commerce"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Storefront integration overview"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"publish","__idx":3},"children":["Publish"]},{"$$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":"Guide"},"children":["Guide"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/miniapps/guides/marketplace"},"children":["Marketplace listing"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Metadata, icons, copy"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/miniapps/examples"},"children":["Examples"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Dropbox, Slack, GitHub, Salla"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"reference","__idx":4},"children":["Reference"]},{"$$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":"Guide"},"children":["Guide"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/miniapps/reference/api-reference"},"children":["API reference"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["REST + GraphQL surface"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/miniapps/guides/best-practices"},"children":["Best practices"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Security and quality"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/miniapps/guides/troubleshooting"},"children":["Troubleshooting"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Common builder issues"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"related","__idx":5},"children":["Related"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/partners"},"children":["Partners program"]}," — Whitelabel and embedded commerce"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/developers/guides/webhooks"},"children":["Tenant webhooks"]}," — Outbound workspace events (separate from MiniApp inbound webhooks)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/sdk/dashboard-sdk"},"children":["Dashboard SDK"]}," — Inbox iframe panels that call ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["executeMiniAppAction"]}]}]}]},"headings":[{"value":"MiniApps","id":"miniapps","depth":1},{"value":"Start here","id":"start-here","depth":2},{"value":"Core concepts","id":"core-concepts","depth":2},{"value":"Publish","id":"publish","depth":2},{"value":"Reference","id":"reference","depth":2},{"value":"Related","id":"related","depth":2}],"frontmatter":{"title":"MiniApps","titleTranslationKey":"products.miniapps","description":"Build JSON-driven integrations for the Karzoun Marketplace — auth, actions, triggers, and webhooks.","audience":"developer","status":"published","locales":["en","ar"],"seo":{"title":"MiniApps"}},"lastModified":"2026-06-23T12:06:12.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/miniapps","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}