# Quickstart

Make your first call to the Karzoun public GraphQL API in under five minutes.

Create an app token
1. Open **Developer → Apps** (`/developer/apps`)
2. Create an app and copy the JWT from the `appsAdd` response
3. Store it securely — it is shown once



```bash
-H "x-app-token: YOUR_APP_TOKEN_JWT"
```

Keep tokens secret
Never commit app tokens to git or expose them in client-side JavaScript.

Find your GraphQL URL
Your tenant GraphQL endpoint:


```
https://{subdomain}.api.{domain}/graphql
```

Example: `https://dev.api.karzoun.chat/graphql`

The hosted MCP endpoint is the same origin with `/mcp` instead of `/graphql`.

Run a query
Try this query to list tags:


```graphql
query {
  tags(page: 1, perPage: 5) {
    data { _id name }
    pagination { totalCount }
  }
}
```


```bash
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: 5) { data { _id name } } }"}'
```

Try this query in Playground
## Next steps

- [Authentication](/developers/getting-started/authentication)
- [GraphQL API Reference](/developers/apis/public-api)