Skip to main content
Gamma logo
  • Category: ai content generation
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 9
  • Triggers: 0
  • Slug: GAMMA
  • Version: 20261101_00

Tools

Slug: GAMMA_CREATE_FROM_TEMPLATETool to create new Gamma content based on an existing template. Use when you need to generate content with a predefined structure/layout by providing custom instructions and prompt. The API creates content asynchronously. This action polls the generation status and returns the gammaUrl when complete, or a generationId if the 2-minute timeout is reached.

Input Parameters

string
required
Text instructions, image URLs, and guidance for adapting the template. Supports 1-100,000 tokens. Can include content to fill into the template and specific customization instructions.
string
required
Unique identifier of the gamma template to use as the base for content generation. This determines the structure and layout of the generated content.
string
Theme identifier obtained from the List Themes API. Use the ‘id’ field (e.g., ‘chisel’, ‘alien’, ‘aurora’), NOT the ‘name’ field which contains human-readable theme names. If not specified, uses the template’s default theme.
string
Additional export format for the generated content. Options: ‘pdf’ (static document) or ‘pptx’ (editable PowerPoint). Download links expire after a period—download promptly.
array
Array of folder IDs where the generated gamma should be stored. Use List Folders API to get available folder IDs.
object
Image generation options for template content. Docs: https://developers.gamma.app/docs/image-models
object
Access control options for the generated content. Docs: https://developers.gamma.app/docs/how-does-the-generations-api-work#sharingoptions

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GAMMA_EDIT_GAMMAApply an edit and poll up to 120 seconds for completion.

Input Parameters

string
required
Natural-language edit instruction, up to 10,000 characters.
string ("lite" | "standard" | "max")
Model effort tier: lite, standard, or max.
string
required
Gamma file ID or page document ID.
boolean
Whether to disable workspace connector access for this edit.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GAMMA_EXPORT_GAMMAExport an existing Gamma and poll up to 120 seconds for its download URL.

Input Parameters

string
required
Gamma file ID or document ID.
string ("pdf" | "png" | "pptx")
required
Export format: PDF, PPTX, or a ZIP containing PNG card images.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GAMMA_GENERATE_GAMMAGenerate a Gamma presentation, document, webpage, or social media content using AI. The action polls the asynchronous generation for up to two minutes, returning available URLs on completion or a generation ID on timeout.

Input Parameters

string
Output type. ‘presentation’ (slide deck), ‘document’ (continuous page/report), ‘webpage’ (web page), ‘social’ (Instagram/TikTok/LinkedIn posts). Default: ‘presentation’
string
Visual theme identifier defining color palette and typography. To use the default theme, omit this field entirely — do NOT pass ‘default’ as a value. IMPORTANT: Theme IDs cannot be guessed - you MUST retrieve them using the List Themes API first. Standard themes use lowercase words (‘alien’, ‘aurora’), hyphens (‘default-dark’, ‘blue-steel’), or alphanumeric IDs (‘ag4mc9ggtxi8iyi’). Custom workspace themes use ‘theme_’ prefix (‘theme_abc123xyz’). DO NOT use underscore-separated words like ‘corporate_blue’ - these are invalid. Both standard (global) and custom (workspace-specific) themes are supported.
string
Additional download format alongside Gamma URL. ‘pdf’ (static document) or ‘pptx’ (editable PowerPoint). Links provided in GET response expire after time—download promptly.
integer
Number of cards to create (when cardSplit=‘auto’). Pro users: 1-60, Ultra users: 1-75. Default: 10
string
required
Content transformation mode. ‘generate’ (AI expands brief inputs into full content), ‘condense’ (summarizes long text to fit slides), ‘preserve’ (keeps exact wording, adds structure).
string
Card division logic. ‘auto’ (AI splits into numCards slides, ignores \n---\n), ‘inputTextBreaks’ (splits at each \n---\n marker, ignores numCards). Default: ‘auto’
array
Target folder(s) for storing the generated gamma. Retrieve available folder IDs using the List Folders API. Multiple folders can be specified.
string
required
Text and image URLs to generate gamma from. Can be brief (few words) or extensive (pages). Token limits: 100,000 tokens (~400,000 characters). Image URLs can be included where they should appear. Use ‘\n---\n’ to control card splits.
object
object
string
Extra specifications for content, layouts, etc. Character limits: 1-2000.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GAMMA_GET_GAMMARetrieve metadata for one Gamma by file ID or document ID.

Input Parameters

string
required
Gamma file ID or document ID from its gamma.app URL.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GAMMA_GET_GAMMA_FILE_URLSRetrieve Classic generation status and available file URLs by generation ID. Poll until the status is completed or failed.

Input Parameters

string
required
The generationId obtained from the POST generations endpoint. Must contain only letters and numbers (alphanumeric characters).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GAMMA_LIST_FOLDERSTool to retrieve a paginated list of folders in your Gamma workspace. Use when you need folder IDs to organize generated content or to search for specific folders by name.

Input Parameters

string
Cursor token for fetching the next page. Use the nextCursor value from the previous response. Pagination is forward-only.
integer
Number of items to return per page. Maximum: 50.
string
Search by name (case-insensitive). Filters results to items matching the search term.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GAMMA_LIST_THEMESFetch the list of themes available in your workspace. Returns both standard (global) and custom (workspace-specific) themes in a paginated format. Use this to discover available theme IDs and names for use with the Generate API. Filter by name using the query parameter.

Input Parameters

string
Cursor token for pagination. Use the nextCursor value from the previous response to fetch the next page.
integer
Maximum number of themes to return per page. Must be between 1 and 50.
string
Search themes by name. Filter the list to only themes matching this query string.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GAMMA_SEARCH_GAMMASSearch accessible Gamma documents by text, creator, or update time.

Input Parameters

integer
Maximum number of hits to return (1-25).
string
Full-text query matched against Gamma titles and body text.
string
Creator filter: ‘me’, an email address, or a user ID.
string
Inclusive ISO-8601 lower bound on the last-updated time.
string
Inclusive ISO-8601 upper bound on the last-updated time.
boolean
Whether archived Gammas are included. Defaults to false.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not