What is the Gamma API?
Have a deck you love? What if you could create 100 more just like it, personalized for different audiences across the world?
The Gamma Generate API allows you to create presentations, documents, webpages, and social posts programmatically without using the Gamma app directly. This is perfect for users who want to automate their workflows using tools like Zapier, Make, or n8n, integrate beautiful presentation generation into their own applications, or create presentations at scale through backend code integration.
And if you're a developer, you can integrate Gamma into your application to give it design superpowers!
💎 Pro Tip: Anyone with a Pro account or greater can access the API today with generous usage limits.
Is the API Ready?
The Gamma API v1.0 has been Generally Available (GA) since November 5, 2025. Anyone with a Pro account or greater can access the API today with generous usage limits.
For detailed information about specific API parameters and how they affect presentation generation, refer to our API documentation.
How Do I Get Access?
To access the Gamma API, follow these steps.
Step 1: Upgrade Your Account
You must have a Gamma Pro, Ultra, Team or Business account. If you're not currently a Pro user or greater, upgrade to Pro to access the API.
Step 2: Generate an API Key
Navigate to Settings and Members in your Pro account, then go to the API key tab. Click Create API key to generate your key, then copy and securely store your API key.
🔷 Note: API keys use the format sk-gamma-xxxxxxxx and should be passed using the X-API-KEY header (not Bearer token format).
💎 Pro Tip: Start using the API with your favorite automation tools or integrate directly into your backend code. The base URL is https://public-api.gamma.app/v1.0/
Can I authenticate with OAuth instead of an API key?
You can authenticate with the Gamma REST API using OAuth 2.0 instead of a static API key. OAuth lets you connect the Gamma API to an application without creating or storing a long-lived API key, which is useful for integrations and partner apps. Static API keys are still fully supported, so you can keep using the X-API-KEY header if you prefer. To set up OAuth, follow the Authenticate with OAuth guide in the developer documentation at developers.gamma.app/get-started/authenticate-with-oauth.
Usage and Rate Limits
Current API Limits
Gamma's API is built to scale with your needs. Whether you're generating a few presentations or hundreds, you should be able to create based on your usage requirements without running into limits during normal use.
🌀 Insight: If you encounter rate limiting (HTTP 429 errors), reach out to our support team. We'll work with you to make sure the API supports what you're building!
What the API can do
The Gamma API covers the full lifecycle of a gamma, from creation to export.
Generate content: Create presentations, documents, webpages, and social posts from your own text.
Create from template: Generate new gammas from a template you built in Gamma, keeping its layout and card structure.
Edit existing gammas: POST /v1.0/agent/gammas/{gammaId}/edits applies a natural-language change to one page.
Agent generation: POST /v1.0/agent/generations starts a generation from a workspace template, an existing gamma, or an official Gamma template.
Read, export, and analyze existing gammas: Get, comments, export, and analytics endpoints.
Standalone image generation: Generate individual images separately from a full gamma.
Webpage format: Generate web pages in addition to presentations, documents, and social posts.
Headers and footers customization: Customize your content's headers and footers.
Image URLs in input: Reference images directly in your content.
Folder organization: Organize generated content into folders.
Email sharing: Share content via email programmatically.
List APIs: Endpoints to list your themes and folders.
Search gammas: Search the titles and full body text of the gammas you can access, and filter results before opening them.
Generous input limits: Up to 100,000 tokens (around 400,000 characters).
Can I generate standalone images with the API?
You can generate standalone images with the Gamma API and through the Model Context Protocol (MCP). This lets you create individual images programmatically, separately from generating a full presentation, document, or webpage. To generate images through the API or MCP, follow the Create image generation guide in the developer documentation. Image generation through MCP is available in Claude, ChatGPT, and other MCP clients.
Can I search my gammas with the API or MCP?
You can search your entire library of gammas from the Gamma API or through an AI assistant connected to Gamma with the Model Context Protocol (MCP), an open standard that lets AI assistants connect to tools like Gamma. Search looks across both the titles and the full body text of every gamma you have access to, and ranks results by relevance so the closest match appears first. Each result includes a direct link, so you can open the gamma straight from the response.
You can narrow your search by who created the gamma and by when it was last updated. Archived gammas are excluded by default, and you can choose to include them.
For the full list of search parameters and example requests, follow the Search gammas guide in the developer documentation at developers.gamma.app/management/search-gammas.
What Can I Use the API For?
Leverage the Gamma API for automation platforms like Make, Zapier, Workato, and other workflow tools. You can also build custom applications with direct integration into backend code to power your own apps, generate bulk presentations by creating multiple presentations programmatically, or create personalized content at scale.
🔷 Note: Your inputText should contain the actual content you want on your slides, not instructions about how to create the presentation. Themes must be pre-created in Gamma and referenced by ID. They cannot be created through inputText.
Template Support
Because "templates" means different things to different users, here's what's available.
Visual themes: You can define the look and feel of your presentations by creating custom themes in Gamma, then referencing them in the API using their theme ID. Use the List Themes API (GET /v1.0/themes) to get available theme IDs.
Content structure templates: Use Create from template. Build a template in Gamma, then call POST /v1.0/generations/from-template with its ID and a prompt. The template's layout and card structure are kept by default, and your prompt changes the content, audience, or language. Templates must be single-page gammas from your workspace (a page can hold many cards). Find template IDs with GET /v1.0/templates/search.
Agent generation: POST /v1.0/agent/generations can also start from a workspace template, an existing gamma, or an official Gamma template (templateId).
Getting Help and Support
Documentation and resources
For complete technical reference, visit the developer documentation at developers.gamma.app. API access is included with Pro, Ultra, Teams, and Business subscriptions.
Debugging help
When you need help with API issues, check our error documentation for common issues and solutions, then reach out to Customer Support. Always include the x-request-id from your API response when asking for help.
Every API response includes this unique identifier in the headers. For **Make.com users**, find it under Output → Bundle → Headers. For Zapier, check Run Details → Data Out section in Task History for successful runs, or Logs tab → Response information (expand headers) for failed requests.
💎 Pro Tip: Always include your request ID, the exact error message, and a sample of your request body when requesting support.
Support Scope
We Can Help With
We can help with Gamma-specific API issues, authentication and API key problems, understanding error messages, rate limit questions, and credit usage questions.
We Cannot Help With
We cannot debug or write custom code, build complete workflows in Zapier, Make, or N8N, debug custom applications, provide directions on using Zapier, Make, or N8N, or design custom architecture.
When requesting API help, please provide your request ID, error message, request body sample, and what automation platform you're using.
Common Error Codes
401 Unauthorized: Invalid API key. Make sure you're using the X-API-KEY header (not Authorization or Bearer).
403 Forbidden: Check your credit balance and ensure auto-recharge is enabled.
429 Too Many Requests: You've hit the rate limit. Contact Slack support for higher capacity options.
422 Failed: Generation couldn't complete. Check your input parameters.
Need Help Getting Started?
For basic troubleshooting and common API issues, check out our comprehensive troubleshooting guide. You can also review our complete developer documentation for detailed API reference and examples.
FAQs & Common Issues
Can I edit an existing gamma with the API?
Yes.
POST /v1.0/agent/gammas/{gammaId}/editsapplies a natural-language instruction to one page of a gamma you can edit, for example "update the pricing card with the new tiers."Poll
GET /v1.0/agent/edits/{editId}for the result.Edits can't add pages, and only one edit runs on a page at a time.
The same capability is available in Claude, ChatGPT, Slack, and other MCP clients.
Can my own AI agent use Gamma?
Yes. Connect any MCP client to
https://mcp.gamma.app/mcpand sign in with your Gamma account. It works on every plan.Custom clients need their OAuth redirect URIs registered first.
Can I share my API keys with others?
API keys should be kept secure and not shared.
Generate separate keys for different use cases if needed.
Why can't I copy my API key again?
For security reasons, API keys are only shown once when generated.
If you lose your key, you'll need to generate a new one.
Can I generate multiple API keys?
Yes, you can create multiple API keys for different projects or use cases through your account settings.
Which gammas show up in API or MCP search results?
Search only returns gammas you already have access to, so it never exposes content you can't open in Gamma.
Results are ranked by relevance, with the closest match to your query first.
Archived gammas are left out unless you choose to include them.
You can also filter by creator and by when a gamma was last updated.
Why doesn't search work in my workspace?
Search across your gammas is rolling out gradually and isn't enabled for every workspace yet.
If it isn't available, contact Customer Support and include your
x-request-idso we can check your workspace.Editor: delete this FAQ if search is confirmed at 100%.
What happens if I run out of credits?
Enable auto-recharge in your billing settings at gamma.app/settings/billing to ensure uninterrupted API access.
Where do API-generated presentations appear in the Gamma dashboard?
Presentations created via the API appear in the API Generated section of the Gamma dashboard, not in your main Gammas list (All, Recently Viewed, or Created by You).
To make an API-generated presentation appear in your regular Gammas list, open it and select Duplicate. The duplicate is treated as a standard web-created gamma and will show up in all the usual views.