Gamma Developer Docs

Build with the Gamma API — generate presentations, documents, websites, and social posts programmatically.

One API call. Polished presentations, documents, websites, and social posts — branded, exported, and shared.

Get your API keyAPI overview

Authentication

All requests require an API key in the X-API-KEY header. Generate a key from Account Settings > API Keys.

Header	Value	Required
X-API-KEY	Your API key	Yes
Content-Type	application/json	Yes

API key access requires a Pro, Ultra, Teams, or Business plan. Some connectors work on all plans and do not require an API key.

Machine-readable docs are available at developers.gamma.app/llms.txt and developers.gamma.app/llms-full.txt. Every page is also available as markdown by appending .md to the URL.

Quickstart

1. Start a generation

cURL

curl -X POST https://public-api.gamma.app/v1.0/generations \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: $GAMMA_API_KEY" \
  -d '{
    "inputText": "Q3 product launch strategy",
    "textMode": "generate",
    "format": "presentation",
    "numCards": 10,
    "exportAs": "pdf"
  }'

Python

JavaScript

Response

{
  "generationId": "abc123xyz"
}

2. Poll for the result

Poll GET /v1.0/generations/{generationId} every 5 seconds until status is completed or failed. Full polling examples in Poll for results.

Response (completed)

{
  "generationId": "abc123xyz",
  "status": "completed",
  "gammaUrl": "https://gamma.app/docs/abc123",
  "exportUrl": "https://gamma.app/export/abc123.pdf",
  "credits": {
    "deducted": 15,
    "remaining": 485
  }
}

3. Use your Gamma

Your presentation is live at gammaUrl. If you specified exportAs, the file is ready at exportUrl.

Getting a 401? Gamma uses X-API-KEY as a custom header — not Authorization: Bearer. See Error codes for other common issues.

Endpoints

Endpoint	Method	Description
/generations	POST	Generate from text
/generations/from-template	POST	Generate from template
/generations/{id}	GET	Poll generation status
/themes	GET	List workspace themes
/folders	GET	List workspace folders

Building an AI integration? The MCP server lets AI tools create gammas on behalf of users via OAuth with Dynamic Client Registration.

Next steps

Generate from text

Control format, themes, images, headers/footers, and sharing.

Generate from a template

Design a template once, then generate variations programmatically.

Connect integrations

Use Gamma with AI assistants and automation platforms — some require no API key.

Set up the MCP server

Let AI tools create gammas on behalf of users via OAuth.