Skip to main content

Gamma API Troubleshooting

Support scope, common error codes and the troubleshooting steps to take.

Gamma API Troubleshooting Guide

While we'd love to help with all things API, keep in mind our support team can't build workflows, debug your backend code (FastAPI, Express, Django, etc.), or troubleshoot platform-specific quirks.

We can help with Gamma-specific questions about our endpoints and parameters, API authentication, error troubleshooting, credits, and verifying your request matches our documentation.

For platform-specific help, contact Zapier Support, Make Support, or N8N Support.

For more information on Gamma's API, see: developers.gamma.app

Common error codes

400 Bad Request

Invalid parameters

Check your request for:

  • Missing required fields (inputText, textMode).

  • Invalid parameter values.

  • Character or token limits exceeded.

  • For from-template: the template must be a single-page workspace gamma. Official Explore templates and multi-page gammas are rejected.

Review the error message for specific validation details.

401 Unauthorized

Invalid API key

Your API key is invalid or not associated with a Pro account.

  1. Verify you're using the X-API-KEY header (not Authorization).

  2. Generate a new API key at gamma.app/settings/api-keys.

  3. Confirm your account has an active Pro, Ultra, Teams, or Business plan.

403 Forbidden

No credits available

Your account has run out of API credits.

Fix this at gamma.app/settings/billing:

  • Enable auto-recharge (recommended).

  • Purchase credits ad hoc.

  • Upgrade to a higher tier plan.

404 Not Found

Invalid generation or gamma ID

The generation ID doesn't exist or belongs to another user. This error is also returned for a gamma ID you can't access when reading, editing, or exporting an existing gamma.

Check that you're using the correct generationId from the POST response, or that you have access to the gamma you're targeting.

422 Failed

Generation couldn't complete

The generation produced empty output.

Review your request:

  • Ensure inputText has sufficient content.

  • Check that parameters align with your input.

  • Simplify complex instructions if needed.

429 Too Many Requests

Rate limit exceeded

You've hit the rate limit. Limits are set per API key owner and per workspace, and the current values are documented in the error-codes reference.

➡️ developers.gamma.app/reference/error-codes

🔷 Note: The API has generous capacity. Most users never encounter this limit in normal usage.

Solutions:

  1. Contact Gamma Support for higher capacity.

  2. Implement exponential backoff.

  3. Spread requests over time.

500 Internal Server Error

Unexpected server error

A temporary server issue occurred.

  1. Wait a moment and retry.

  2. If persistent, contact support with your x-request-id.

502 Bad Gateway

Temporary gateway issue

A temporary connection issue occurred.

Wait a moment and retry your request.

My API-generated presentation isn't in my Gammas list

API-generated presentations appear in the API Generated section of the Gamma dashboard, not in your main Gammas list (All, Recently Viewed, or Created by You). This is expected behaviour, and renaming the presentation does not change how it is categorised.

Workaround: Open the presentation and select Duplicate. The duplicate is treated as a regular web-created gamma and will appear in your main Gammas list.

Still need help?

Related Articles
Did this answer your question?