Skip to main content

Gamma API Troubleshooting

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

Updated over a week ago

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/token limits exceeded

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/billing

  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.

  • Enable auto-recharge (recommended)

  • Purchase credits ad hoc

  • Upgrade to a higher tier plan


404 Not Found

Invalid generation ID

The generation ID doesn't exist or belongs to another user.

Check that you're using the correct generationId from the POST response.


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 (50 generations/hour).

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.


Still Need Help?

Did this answer your question?