Gamma

Overview

Gamma is an AI-powered content creation platform that lets you generate presentations, documents, web pages, and social media posts quickly and with visual polish. With the Gamma integration in SquadOS, your agents can create and customize Gamma content programmatically — from text-to-presentation to template-based documents — without ever opening the editor manually.

• Official website: https://gamma.app/
• Composio documentation: docs.composio.dev/toolkits/gamma

Authentication

This tool uses API key (API_KEY) to connect.

You will need the following fields:

Field	Required	Description
api_key	Yes	API key from your Gamma account, obtained in the developer settings.

How to get credentials

1. Go to gamma.app and log in to your account.
2. Click your avatar in the top-right corner and open Settings.
3. Navigate to the API or Developer tab.
4. Click Generate API Key and copy the generated value.

Tip

Keep your API key secure. It grants full programmatic access to your Gamma account for creating and managing content.

How to connect in SquadOS

1. Go to Tools in the side menu (/admin/tools).
2. Open the Available tab and search for Gamma.
3. Click the card to open the details modal and hit Connect.
4. You’re taken to the secure connection page hosted by Composio, where you enter the API key obtained above.
5. Once done, you’re sent back to SquadOS with the account connected and the tool available for your agents. (Connection-flow details in Organization Tools.)

Available actions

Create from Template

GAMMA_CREATE_FROM_TEMPLATE

Tool 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

Name	Type	Required	Description
prompt	string	Yes	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.
gammaId	string	Yes	Unique identifier of the gamma template to use as the base for content generation. This determines the structure and layout of the generated content.
themeId	string	No	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.
exportAs	string	No	Additional export format for the generated content. Options: ‘pdf’ (static document) or ‘pptx’ (editable PowerPoint). Download links expire after a period—download promptly.
folderIds	array	No	Array of folder IDs where the generated gamma should be stored. Use List Folders API to get available folder IDs.
imageOptions	object	No	Image generation options for template content. Docs: https://developers.gamma.app/docs/image-models
sharingOptions	object	No	Access control options for the generated content. Docs: https://developers.gamma.app/docs/how-does-the-generations-api-work#sharingoptions

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during the execution of the action.
successful	boolean	Yes	Whether or not the action execution was successful.

Generate a Gamma

GAMMA_GENERATE_GAMMA

Generate a Gamma presentation, document, webpage, or social media content using AI. The API creates content asynchronously. Poll the returned generationId to check status.

Input parameters

Name	Type	Required	Description
format	string	No	Output type. ‘presentation’ (slide deck), ‘document’ (continuous page/report), ‘webpage’ (web page), ‘social’ (Instagram/TikTok/LinkedIn posts). Default: ‘presentation’
themeId	string	No	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.
exportAs	string	No	Additional download format alongside Gamma URL. ‘pdf’ (static document) or ‘pptx’ (editable PowerPoint). Links provided in GET response expire after time—download promptly.
numCards	integer	No	Number of cards to create (when cardSplit=‘auto’). Pro users: 1-60, Ultra users: 1-75. Default: 10
textMode	string	Yes	Content transformation mode. ‘generate’ (AI expands brief inputs into full content), ‘condense’ (summarizes long text to fit slides), ‘preserve’ (keeps exact wording, adds structure).
cardSplit	string	No	Card division logic. ‘auto’ (AI splits into numCards slides, ignores \n---\n), ‘inputTextBreaks’ (splits at each \n---\n marker, ignores numCards). Default: ‘auto’
folderIds	array	No	Target folder(s) for storing the generated gamma. Retrieve available folder IDs using the List Folders API. Multiple folders can be specified.
inputText	string	Yes	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.
cardOptions	object	No	Card layout options. Docs: https://developers.gamma.app/docs/how-does-the-generations-api-work#cardoptions
textOptions	object	No	Text generation options. Docs: https://developers.gamma.app/docs/how-does-the-generations-api-work#textoptions
imageOptions	object	No	Image options for gamma generation. Docs: https://developers.gamma.app/docs/how-does-the-generations-api-work#imageoptions
sharingOptions	object	No	Sharing and access control options. Docs: https://developers.gamma.app/docs/generate-api-parameters-explained
additionalInstructions	string	No	Extra specifications for content, layouts, etc. Character limits: 1-2000.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during the execution of the action.
successful	boolean	Yes	Whether or not the action execution was successful.

Get Gamma File URLs

GAMMA_GET_GAMMA_FILE_URLS

Retrieve generation status and file URLs. Poll this endpoint every ~5 seconds until status is ‘completed’. Docs: https://developers.gamma.app/reference/get-generation-status

Input parameters

Name	Type	Required	Description
generation_id	string	Yes	The generationId obtained from the POST generations endpoint. Must contain only letters and numbers (alphanumeric characters).

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during the execution of the action.
successful	boolean	Yes	Whether or not the action execution was successful.

List Folders

GAMMA_LIST_FOLDERS

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

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

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during the execution of the action.
successful	boolean	Yes	Whether or not the action execution was successful.

List Themes

GAMMA_LIST_THEMES

Fetch 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

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

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during the execution of the action.
successful	boolean	Yes	Whether or not the action execution was successful.