{"templateId":"GuidePage","sharedDataIds":{"sidebar":"sidebar-developers/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["endpoint-badge","guide-step","partial","callout","split","playground-button"]},"type":"markdown"},"seo":{"title":"Quickstart","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":"quickstart","__idx":0},"children":["Quickstart"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Make your first call to the Karzoun public GraphQL API in under five minutes."]},{"$$mdtype":"Tag","name":"EndpointBadge","attributes":{"method":"POST","path":"/graphql"},"children":[]},{"$$mdtype":"Tag","name":"Step","attributes":{"number":1,"title":"Create an app token"},"children":[{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Open ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Developer → Apps"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/developer/apps"]},")"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Create an app and copy the JWT from the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["appsAdd"]}," response"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Store it securely — it is shown once"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"-H \"x-app-token: YOUR_APP_TOKEN_JWT\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Callout","attributes":{"type":"warning","title":"Keep tokens secret"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Never commit app tokens to git or expose them in client-side JavaScript."]}]}]},{"$$mdtype":"Tag","name":"Step","attributes":{"number":2,"title":"Find your GraphQL URL"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Your tenant GraphQL endpoint:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"https://{subdomain}.api.{domain}/graphql\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://dev.api.karzoun.chat/graphql"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The hosted MCP endpoint is the same origin with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/mcp"]}," instead of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/graphql"]},"."]}]},{"$$mdtype":"Tag","name":"Step","attributes":{"number":3,"title":"Run a query"},"children":[{"$$mdtype":"Tag","name":"Split","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Try this query to list tags:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"graphql","header":{"controls":{"copy":{}}},"source":"query {\n  tags(page: 1, perPage: 5) {\n    data { _id name }\n    pagination { totalCount }\n  }\n}\n","lang":"graphql"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X POST 'https://YOUR_SUBDOMAIN.api.karzoun.chat/graphql' \\\n  -H 'Content-Type: application/json' \\\n  -H 'x-app-token: YOUR_APP_TOKEN' \\\n  -d '{\"query\":\"query { tags(page: 1, perPage: 5) { data { _id name } } }\"}'\n","lang":"bash"},"children":[]}]},{"$$mdtype":"Tag","name":"PlaygroundButton","attributes":{"label":"Try this query in Playground","query":"query { tags(page: 1, perPage: 5) { data { _id name } pagination { totalCount } } }","variant":"outlined"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"next-steps","__idx":1},"children":["Next steps"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/developers/getting-started/authentication"},"children":["Authentication"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/developers/apis/public-api"},"children":["GraphQL API Reference"]}]}]}]},"headings":[{"value":"Quickstart","id":"quickstart","depth":1},{"value":"Next steps","id":"next-steps","depth":2}],"frontmatter":{"title":"Quickstart","titleTranslationKey":"sidebar.developers.quickstart","description":"Make your first Karzoun GraphQL API call.","audience":"developer","status":"published","locales":["en","ar"],"template":"GuidePage","seo":{"title":"Quickstart"}},"lastModified":"2026-06-23T12:06:12.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/developers/getting-started/quickstart","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}