# Gamma

Gamma helps create beautiful, interactive content and presentations using AI. This integration enables programmatic generation via Gamma’s API.

- **Category:** ai content generation
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 5
- **Triggers:** 0
- **Slug:** `GAMMA`
- **Version:** 20260225_00

## Tools

### Create from Template

**Slug:** `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

| Parameter | 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

| Parameter | 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 or not |

### Generate a Gamma

**Slug:** `GAMMA_GENERATE_GAMMA`

Generate a Gamma presentation, document, webpage, or social media content using AI. Documentation: https://developers.gamma.app/docs/generate-api-parameters-explained The API creates content asynchronously. Poll the returned generationId to check status.

#### Input Parameters

| Parameter | 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

| Parameter | 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 or not |

### Get Gamma File URLs

**Slug:** `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

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

#### Output

| Parameter | 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 or not |

### List Folders

**Slug:** `GAMMA_LIST_FOLDERS`

Tool 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

| Parameter | 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

| Parameter | 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 or not |

### List Themes

**Slug:** `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

| Parameter | 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

| Parameter | 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 or not |