> ## Documentation Index
> Fetch the complete documentation index at: https://docs.karzoun.chat/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Build integrations with the Karzoun public GraphQL API — app tokens, webhooks, MCP, SDK, and MiniApps.

Welcome to the Karzoun **GraphQL API** docs — guides, playground, and schema for partner app builders, integration engineers, and teams wiring AI agents that need live, permissioned access to workspace data.

Sales, support, and marketing already share one Karzoun workspace. Your integration inherits that unity: one app token model, one permission story, one customer record across channels.

<Info>
  Looking for day-to-day product how-tos? Start from the [docs home](/) or [Help Center](/help-center) — this section is for builders.
</Info>

## Choose your path

<Columns cols={2}>
  <Card title="Quickstart" icon="rocket" href="/developers/getting-started/quickstart">
    First authenticated GraphQL call in minutes.
  </Card>

  <Card title="Authentication" icon="key" href="/developers/getting-started/authentication">
    Apps, tokens, and how requests are authorized.
  </Card>

  <Card title="GraphQL API" icon="brackets" href="/api-reference">
    Schema reference — queries, mutations, and types.
  </Card>

  <Card title="Webhooks" icon="webhook" href="/developers/guides/webhooks">
    React to conversation, contact, and app events.
  </Card>

  <Card title="MCP" icon="bot" href="/mcp-server">
    Tool access for Cursor, Claude, and agents.
  </Card>

  <Card title="MiniApps" icon="puzzle" href="/miniapps">
    JSON Marketplace apps — build locally, submit for review.
  </Card>
</Columns>

## When to use what

| Need                         | Prefer            | Why                                             |
| ---------------------------- | ----------------- | ----------------------------------------------- |
| Read/write data on demand    | **GraphQL**       | Full schema, playground, precise queries        |
| React when something happens | **Webhooks**      | Push events to your server with signatures      |
| AI client needs tools        | **MCP**           | Permissioned tools over the same workspace data |
| Embed UI in the inbox        | **Dashboard SDK** | iframe apps calling `executeMiniAppAction`      |
| Ship a reusable connector    | **MiniApps**      | Marketplace JSON definition + review            |

## Security checklist

* Store app tokens on the server — never in client JavaScript or public repos
* Verify webhook signatures (`x-karzoun-signature-256`) before trusting payloads
* Scope each app to the least privileges your integration needs
* Rotate tokens when people leave or integrations are retired

## Try it

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -X POST 'https://YOUR_SUBDOMAIN.api.karzoun.chat/graphql' \
  -H 'Content-Type: application/json' \
  -H 'x-app-token: YOUR_APP_TOKEN' \
  -d '{"query":"query { tags(page: 1, perPage: 3) { data { name } } }"}'
```

<Tip>
  Prefer a visual editor? Open the [GraphQL Playground](/api-reference/playground).
</Tip>

## What your integration can touch

| Area           | Examples                                                                   |
| -------------- | -------------------------------------------------------------------------- |
| Shared inbox   | Omnichannel conversations — WhatsApp, email, webchat, Messenger, Instagram |
| CRM & segments | Customers, companies, tags, custom fields, dynamic segments                |
| Automations    | Triggers, conditions, and actions across inbox and channels                |
| AI             | Copilot and agents grounded in CRM and conversation context                |
| Marketing      | Broadcasts, templates, and campaign analytics                              |
| Operations     | Tasks, orders, meetings, files, team chat                                  |

<Note>
  Field-level docs live in the [GraphQL reference](/api-reference). Non-technical product guides live in the [Help Center](/help-center).
</Note>


## Related topics

- [Overview](/developers/index.md)
- [Partner onboarding](/partners/onboarding.md)
- [Email channels](/help-center/guides/channels/email-channels.md)
- [MCP](/mcp-server/index.md)
- [MiniApps](/miniapps/index.md)