---
title: Authentication
url: https://docs.kaltura.com/docs/events-collaboration/gamification-api/gamification-authentication
---

## Authentication

All requests require an ADMIN KS (type=2) in the `Authorization` header:

```bash
# Set up environment
export KALTURA_SCM_URL="https://scm.nvp1.ovp.kaltura.com/api/v1"
export KALTURA_KS="your_kaltura_session"
```

Generate an ADMIN KS via `session.start` (see [Session Guide](/docs/getting-started/authentication/ks-overview)) or `appToken.startSession` (see [AppTokens Guide](/docs/getting-started/authentication/app-tokens-overview)).

### 3.1 Regional Endpoints

| Region | Base URL |
|--------|----------|
| US Production | `https://scm.nvp1.ovp.kaltura.com/api/v1/` |
| DE (Frankfurt) | `https://scm.frp2.ovp.kaltura.com/api/v1/` |
| EU (Ireland) | `https://scm.irp2.ovp.kaltura.com/api/v1/` |
| Canada | `https://scm.cap2.ovp.kaltura.com/api/v1/` |

Gamification runs in these 4 regions only (no Singapore or Australia deployment). See API Getting Started §4.5 for the full microservice regional availability matrix.

### 3.2 Permissions

| Permission | Description |
|------------|-------------|
| `GAME_BASE` | Read operations — list scores, get badges, view reports |
| `GAME_MANAGE` | Write operations — create leaderboards, define rules, manage certificates |

Enable Game Services for your partner account in Kaltura Admin Console.