gamma-install-auth

name	gamma-install-auth
description	Set up Gamma API v1.0 authentication and first request. Use when configuring API keys, setting up X-API-KEY header, or initializing Gamma REST API access in a project. Trigger: "install gamma", "setup gamma API", "gamma auth", "gamma API key", "configure gamma".
allowed-tools	Read, Write, Edit, Bash(curl:*), Bash(npm:*), Bash(pip:*)
version	1.13.0
license	MIT
author	Jeremy Longshore <[e-mail]>
tags	["saas","gamma","api","authentication"]
compatibility	Designed for Claude Code, also compatible with Codex and OpenClaw

Gamma Install & Auth

Overview

Configure authentication for the Gamma Generate API v1.0 (GA since Nov 2025). Gamma uses a REST API at https://public-api.gamma.app/v1.0/ — there is no official SDK package. All requests authenticate via the X-API-KEY header.

Prerequisites

• Gamma Pro account or higher (API access requires Pro+)
• Node.js 18+ or Python 3.10+ for wrapper code
• curl or HTTP client library

Instructions

Step 1: Generate API Key

1. Log in at gamma.app
2. Navigate to Settings and Members (dropdown, upper-left)
3. Select the API key tab
4. Click Create API key
5. Copy and securely store the key — it will not be shown again

Step 2: Configure Environment

# Set environment variable (add to .env or shell profile)
export GAMMA_API_KEY="gma_your_api_key_here"

# .env file approach
echo 'GAMMA_API_KEY=gma_your_api_key_here' >> .env

Step 3: Verify Connection

# Quick verification with curl
curl -s -o /dev/null -w "%{http_code}" \
  -H "X-API-KEY: ${GAMMA_API_KEY}" \
  https://public-api.gamma.app/v1.0/themes
# 200 = authenticated, 401 = invalid key

Step 4: First API Call (Node.js)

// gamma-client.ts — thin wrapper around the REST API
const GAMMA_BASE = "https://public-api.gamma.app/v1.0";

interface GammaConfig {
  apiKey: string;
  baseUrl?: string;
}

export function () {
   headers = {
    : config.,
    : ,
  };
   base = config. ?? ;

   {
     () {
       res =  (, { headers });
       (!res.)   ();
       res.();
    },
     () {
       res =  (, { headers });
       (!res.)   ();
       res.();
    },
  };
}


 gamma = ({ : process..! });
 themes =  gamma.();
.();