Gamma Integration — ModuleX AI

Overview

Add Gamma to any ModuleX agent or workflow. Generate presentations, documents, webpages, and social posts with AI from text, create from templates, check generation status, and browse workspace themes and folders against the Gamma REST API (public-api.gamma.app).

Categories: Marketing & Advertising · Document Processing · Content Management · Auth: API Key · Actions: 5

Authentication

API Key Authentication

Authenticate using your Gamma API key

Step 1

Step 2

Open Account Settings and navigate to the ‘API Keys’ section

Step 3

Create a new API key (format: sk-gamma-xxxxxxxx) or copy an existing one

Step 4

Paste the API key below

Required Credentials

Field	Description	Required	Format
Gamma API Key	Your Gamma API key from Account Settings > API Keys	Yes	`sk-gamma-xxxxxxxxxxxxxxxxxxxxxxxx`

Available Actions

Parameters

string

required

Text and image URLs used to generate your gamma (1-100,000 tokens)

string

required

How to handle input text: generate (AI expands), condense (AI summarizes), or preserve (keep as-is)

string

Output format: presentation, document, webpage, or social (default: presentation)

string

Custom Gamma workspace theme ID (use list_themes to find themes)

integer

Number of cards/slides to generate (1-60 for Pro, 1-75 for Ultra; default: 10)

string

How to split content into cards: auto or inputTextBreaks

string

Card aspect ratio. Presentation: fluid, 16x9, 4x3. Document: fluid, pageless, letter, a4. Social: 1x1, 4x5, 9x16

string

Additional instructions for the AI generation (max 2000 chars)

string

Automatically export the generated gamma as pdf or pptx

string

Comma-separated folder IDs to store the generated gamma in

string

Amount of text per card: brief, medium, detailed, or extensive

string

Tone of the generated text, e.g. “professional” (max 500 chars)

string

Target audience, e.g. “executives”, “students” (max 500 chars)

string

Language code for the generated text (default: en)

string

Where to source images: aiGenerated, pictographic, unsplash, webAllImages, webFreeToUse, webFreeToUseCommercially, giphy, placeholder, or noImages

string

AI image generation model to use when image_source is aiGenerated

string

Style directive for AI-generated images, e.g. “watercolor”

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "generation_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Generation Id"
    },
    "warnings": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Warnings"
    }
  },
  "required": [
    "success"
  ],
  "title": "GenerateOutput",
  "type": "object"
}

generate_from_template — Generate a new Gamma by adapting an existing template with a prompt.

Parameters

string

required

The ID of the template gamma to adapt

string

required

Instructions for how to adapt the template (1-100,000 tokens)

string

Custom Gamma workspace theme ID to apply

string

Automatically export the generated gamma as pdf or pptx

string

Comma-separated folder IDs to store the generated gamma in

string

AI image generation model to use when image_source is aiGenerated

string

Style directive for AI-generated images, e.g. “watercolor”

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "generation_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Generation Id"
    },
    "warnings": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Warnings"
    }
  },
  "required": [
    "success"
  ],
  "title": "GenerateFromTemplateOutput",
  "type": "object"
}

check_status — Check the status of a Gamma generation job. Returns the gamma URL when completed, or error details if failed.

Parameters

string

required

The generation ID returned by generate or generate_from_template

Response

{
  "$defs": {
    "GammaCredits": {
      "additionalProperties": false,
      "description": "Credit usage reported on a completed generation.",
      "properties": {
        "deducted": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Deducted"
        },
        "remaining": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Remaining"
        }
      },
      "title": "GammaCredits",
      "type": "object"
    },
    "GammaError": {
      "additionalProperties": false,
      "description": "Error details reported on a failed generation.",
      "properties": {
        "message": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Message"
        },
        "status_code": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Status Code"
        }
      },
      "title": "GammaError",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "generation_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Generation Id"
    },
    "status": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Status"
    },
    "gamma_url": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Gamma Url"
    },
    "gamma_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Gamma Id"
    },
    "export_url": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Export Url"
    },
    "credits": {
      "anyOf": [
        {
          "$ref": "#/$defs/GammaCredits"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "generation_error": {
      "anyOf": [
        {
          "$ref": "#/$defs/GammaError"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "success"
  ],
  "title": "CheckStatusOutput",
  "type": "object"
}

list_themes — List available themes in your Gamma workspace. Returns theme IDs, names, and keywords for styling.

Parameters

string

Search query to filter themes by name (case-insensitive)

integer

Maximum number of themes to return per page (max 50)

string

Pagination cursor from a previous response (next_cursor)

Response

{
  "$defs": {
    "ThemeItem": {
      "additionalProperties": false,
      "description": "A single theme in ``list_themes``.",
      "properties": {
        "id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Id"
        },
        "name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Name"
        },
        "type": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Type"
        },
        "color_keywords": {
          "items": {
            "type": "string"
          },
          "title": "Color Keywords",
          "type": "array"
        },
        "tone_keywords": {
          "items": {
            "type": "string"
          },
          "title": "Tone Keywords",
          "type": "array"
        }
      },
      "title": "ThemeItem",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "themes": {
      "items": {
        "$ref": "#/$defs/ThemeItem"
      },
      "title": "Themes",
      "type": "array"
    },
    "has_more": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Has More"
    },
    "next_cursor": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Next Cursor"
    }
  },
  "required": [
    "success"
  ],
  "title": "ListThemesOutput",
  "type": "object"
}

list_folders — List available folders in your Gamma workspace. Returns folder IDs and names for organizing generated content.

Parameters

string

Search query to filter folders by name (case-sensitive)

integer

Maximum number of folders to return per page (max 50)

string

Pagination cursor from a previous response (next_cursor)

Response

{
  "$defs": {
    "FolderItem": {
      "additionalProperties": false,
      "description": "A single folder in ``list_folders``.",
      "properties": {
        "id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Id"
        },
        "name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Name"
        }
      },
      "title": "FolderItem",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "folders": {
      "items": {
        "$ref": "#/$defs/FolderItem"
      },
      "title": "Folders",
      "type": "array"
    },
    "has_more": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Has More"
    },
    "next_cursor": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Next Cursor"
    }
  },
  "required": [
    "success"
  ],
  "title": "ListFoldersOutput",
  "type": "object"
}

Limits & Quotas

API key access requires a paid plan (Pro, Ultra, Teams, or Business).
Generation cost is metered in credits; check_status reports credits.deducted and credits.remaining on completion.
list_themes and list_folders cap limit at 50 per page and use a next_cursor cursor (pass it as after) for further pages.
Every response carries rate-limit headers (x-ratelimit-remaining, x-ratelimit-remaining-daily).
Error model: non-2xx responses and timeouts are caught and returned as success=False + error rather than raising. Plan for retries on the agent side based on the error string.

Using

Providers

Building

Tools

Gamma Integration for AI Agents & Workflows

Overview

Authentication

API Key Authentication

Required Credentials

Available Actions

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Limits & Quotas

Ahrefs

Customer.io

Google Ad Manager

Links

​Overview

​Authentication

​API Key Authentication

​Required Credentials

​Available Actions

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Limits & Quotas

​Related integrations

Ahrefs

Customer.io

Google Ad Manager

​Links

Overview

Authentication

API Key Authentication

Required Credentials

Available Actions

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Limits & Quotas

Related integrations

Links