create_slides_shape
Insert shapes like rectangles and arrows into Google Slides. Specify type, position, size, and fill color to build diagrams and layouts programmatically.
Instructions
Create a new shape element (rectangle, ellipse, arrow, etc.) on a Google Slide.
Use this to build layouts programmatically — callouts, diagrams, backgrounds.
For a TEXT-focused box, use create_slides_text_box (simpler + auto-sized
for text). For styling an EXISTING shape (outline, shadow, filled color),
use style_slides_shape. To add text inside a shape after creation, use
batch_update_presentation with insertText.
Requires OAuth scope: https://www.googleapis.com/auth/presentations (write).
Creates exactly one shape per call. Returns the new shape's object ID so
you can reference it in follow-up calls (inserting text, setting fill, etc.).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| user_google_email | Yes | ||
| presentation_id | Yes | Google Slides presentation ID (from the URL after `/d/`). | |
| page_object_id | Yes | Object ID of the slide where the shape will be placed. Get it from `get_presentation.slides[].objectId` or `get_page`. | |
| shape_type | Yes | Shape enum from Google's API. Common values: `RECTANGLE`, `ROUND_RECTANGLE`, `ELLIPSE`, `TRIANGLE`, `RIGHT_TRIANGLE`, `DIAMOND`, `PENTAGON`, `HEXAGON`, `OCTAGON`, `PARALLELOGRAM`, `TRAPEZOID`, `STAR_5`, `STAR_6`, `STAR_8`, `STAR_12`, `STAR_16`, `STAR_24`, `STAR_32`, `ARROW_RIGHT`, `ARROW_LEFT`, `ARROW_UP`, `ARROW_DOWN`, `LEFT_RIGHT_ARROW`, `CLOUD`, `SUN`, `MOON`, `HEART`, `LIGHTNING_BOLT`, `SPEECH`, `CLOUD_CALLOUT`. Full list: https://developers.google.com/slides/api/reference/rest/v1/pages/pageElements#Type | |
| left | No | X position (top-left corner) in EMUs (English Metric Units). Default `914400` EMU = 1 inch from the slide's left edge. Conversion: 1 inch = 914,400 EMU; 1 point = 12,700 EMU; 1 cm = 360,000 EMU. | |
| top | No | Y position (top-left corner) in EMUs. Default `914400` = 1 inch down. | |
| width | No | Shape width in EMUs. Default `2000000` ≈ 2.19 inches. | |
| height | No | Shape height in EMUs. Default `2000000` ≈ 2.19 inches. | |
| fill_color | No | Optional hex color for the shape interior, e.g., `#4285F4`. Accepts `#RRGGBB` or `RRGGBB`. Omit for the default transparent fill (shape renders as an outline only until you set a fill later). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |