Automo

Create a new spreadsheet in the workspace from either a compact `rows` (a row-major 2D array of cell values — the easy way to build a table; a string starting with = is a formula) or a full editor `data` document (e.g. one previously returned by get_spreadsheet). Returns the new spreadsheet's id and an edit_url that opens it in the Automo spreadsheet editor. Styling contract: a cell has NO inline colour or font. Appearance lives in a top-level `styles` registry and each cell points at it — styles: { s1: { background: "#FEF3C7", textColor: "#111827", bold: true } } with `styleId: "s1"` on the cell. Colour written directly on a cell is stored but never rendered. The response returns a `warnings` array when the workbook styles something in a way the editor will not show.

create_spreadsheet

Create a new editable video project from a video template (from list_video_templates). Clones the template's composition with template lineage preserved, so any editing restrictions its author set keep applying. Returns the new project's id and an edit_url that opens it in the Automo video editor; use get_video_project/update_video_project to iterate on it.

create_video_from_template

Create a new video project in the workspace from either a `storyboard` (recommended: scenes with media + durations, captions with word timings, text overlays, image overlays like a brand logo/end-card, music/voiceover) or a raw editor `timeline` document. Pass brand_kit_id to style storyboard text with the brand's font and color. All media must already be uploaded https URLs (use search_brand_assets / search_dam_assets / upload_file). Returns the project id and an edit_url that opens it in the Automo video editor.

create_video_project

Create a new Automo Connect campaign brief (who to reach, what to say, on which channels). Created as a DRAFT — it does not start working until someone activates it in Automo. Returns the new campaign id.

create_campaign

Create a new empty project in the workspace, in whichever editor the person asked for. Pass `mode`: 'design' (default), 'website', 'email', 'presentation' (slide deck / Slides), 'pro_design' (Pro Design WebGL canvas), 'figma' (Figma-layout spread), 'prototype' (interactive prototyping), 'whiteboard' (infinite brainstorming board), or 'photo' (photo editor). Give a canvas size as a named preset (e.g. instagram_post, a4_portrait) OR explicit width+height — not both; modes with a natural size (presentation 1920×1080, whiteboard 4000×4000, prototype 390×844, photo 1920×1080) default it if you pass none. Returns the new project's id and an edit_url that opens it in the right editor — give the person that link.

create_blank_project

Add one company (account) to the workspace CRM. Search first with search_companies — duplicates are not merged. Returns the new company's id so you can attach contacts and deals to it.

create_company

Add one person to the workspace CRM. Search first with search_contacts — this does not merge duplicates, and a second record for someone who already exists is worse than no record. Needs at least a name or an email. Creates a single contact; there is no bulk import.

create_contact

Open a deal in the workspace CRM against a company and/or a contact. Use list_deals first to see which stage names this workspace actually uses — stage is free text and an invented one silently creates a column nobody is looking at.

create_deal

Create a folder in the workspace media library (DAM), optionally inside an existing one, so uploads can be filed instead of landing loose. Returns the folder's id for use with upload_file. If a folder with the same name already exists in the same place, that one is returned instead of creating a duplicate.

create_folder

Create a folder on the projects page (the same folders /create/projects shows) and get its id. START every task that will produce several projects — design variants, an ad set, best-of-N videos — by creating ONE folder named after the task, then pass its id as folder_id to create_blank_project, create_project_from_template, create_video_project and create_video_from_template so every variant lands together. Folders are personal to the acting user. Returns an existing folder instead of a duplicate when one with the same name already exists at that level.

create_project_folder

Create a new project in the workspace from a template (from list_templates). Clones the template's content into a new editable project, preserving any editing restrictions its author set. The canvas size comes from the template. Pass brand_kit_id to record the brand kit on the project (open it in the editor to apply the brand's colors/fonts/logo). Returns the new project's id and edit_url — a link the person opens to edit the design themselves (they sign in if they aren't already). Give them that link.

create_project_from_template

Add one task to the workspace. Leave assigned_to empty unless the person told you who it is for — assigning a task puts it in someone's queue and can trigger their reminders. Link it to a contact, company or deal when it came out of that conversation.

create_task

Move a design, website or email project to the trash — use it to clean up test or stub projects. It stops showing in list_projects and the app (recoverable from the app's trash). Pass the project_type that matches how it was created (default design). For video, spreadsheet or document projects, delete them from the Automo app instead. Irreversible from the connector's side.

delete_project

Delete a file from the workspace media library (DAM) — removes both the stored object and its library entry. Takes a file id from list_files or search_dam_assets. This cannot be undone through the connector, so read the library first and be sure of the id. Files in another member's personal folder or a restricted folder can't be deleted here.

delete_file

Remove an element from a design. Takes an element id from get_project_elements. Nothing else on the page moves to fill the gap. This cannot be undone through the connector, so read the design first and be sure of the id.

delete_element

Fetch the full content behind one search result by its id (from the search tool), returning its title, text, url and metadata. Reaches only what this connection's permissions already allow — an id for something it cannot read answers as not found.

fetch

Register a file uploaded via create_upload_url in the workspace media library, after you have PUT its bytes to the signed URL. Pass the path from create_upload_url (plus the same filename, mime_type and folder_id). Verifies the object landed in storage and returns the stored file's id and public URL.

finalize_upload

Find slots in your own calendar where a meeting of a given length would fit, inside working hours and around everything already booked. Use this before proposing a time, instead of listing the whole diary and working out the gaps. It only reads — booking is create_calendar_event.

find_free_time

Generate a short AI video clip (text-to-video, or image-to-video when reference_images are given). COSTS CREDITS — this tool is consent-gated: calling it WITHOUT user_approved returns a credit estimate for every available model and does NOT charge or generate. You MUST then show the user the estimate, let them pick the model (or confirm the default), and only call again with user_approved: true after the user has explicitly agreed in their own words. Never set user_approved on your own initiative. Models: seedance-1.5-pro (default — balanced quality/cost, up to 2 reference images, 480p/720p/1080p); seedance-2.5 (newest Seedance — best motion & consistency, up to 10 reference images, 480p/720p); seedance-2-fast (animates one first-frame image (product/try-on shots)); wan-2.5 (budget option, one reference image, 5s or 10s); veo-3.1 (Google Veo — native audio, up to 3 reference images, fixed duration); sora-2 (OpenAI Sora — strong scene composition). Returns a job_id — poll get_video_generation every ~20s (clips take 1–3 minutes). The finished clip lands in the media library and can be placed in a video project scene via its URL.

generate_video_clip

Fetch a brand asset (logo, image, graphic) by id and return its actual content — an SVG's source as text, or a raster image inline — so you can embed it even when your sandbox can't reach the asset's URL (the recurring CDN/prod-api egress block). Get ids from get_brand_kit or search_brand_assets. Best for logos and graphics; large media (video) comes back as a URL instead.

get_brand_asset

Read one document in full, including its body. `content` is the stored body and `content_format` tells you what it is (html, content_blocks, or tiptap_json). Keep the returned updated_at — update_document requires it as expected_updated_at so edits can't clobber someone working in the editor. edit_url opens it in the Automo document editor.

get_document

Read one spreadsheet in full, including its complete workbook document (sheets, cells, formulas, formats) exactly as the editor stores it. Keep the returned updated_at — update_spreadsheet requires it as expected_updated_at so edits can't clobber someone working in the editor. edit_url opens it in the Automo spreadsheet editor.

get_spreadsheet

Read one video project in full, including its complete timeline document (tracks, clips, captions, timings) exactly as the editor stores it. Keep the returned updated_at — update_video_project requires it as expected_updated_at so edits can't clobber someone working in the editor. edit_url opens the project in the Automo video editor.

get_video_project

Read one Automo Connect campaign brief in full — audience, goals, voice, automation limits, CRM linkage and the living insights written back by past runs.

get_campaign

Get a brand kit as ready-to-use brand intelligence: colors sorted by semantic role (primary → background → secondary → accent → text), fonts with heading/body roles, logos with detected type (icon/wordmark/full) and background hints, plus brand images, graphic elements, videos and audio — each with its human-written usage description. Use it to produce anything on-brand. Omit brand_kit_id to get the workspace's default kit.

get_brand_kit

Read one CRM contact in full — contact details, address, lead source, tags, owner and custom fields — along with their company and any open deals they are attached to.

get_contact

Read a conversation, oldest first. On a long thread this returns the most recent messages rather than the opening ones, and says so with `truncated`.

get_thread

Read one meeting recording in full: the transcript text, the AI summary, the action items and who spoke. Use it to answer "what did we agree", to draft a follow-up, or to turn action items into tasks. Only recordings you can already open are readable.

get_meeting_transcript

Read one message in full — its body as plain text and as sanitised HTML, plus what is attached to it. Attachment contents are not returned, only their names, types and sizes.

get_message

List what is already on a project's canvas (design, website or email): its pages (with each page's size and background), and for each element its id, type, name, position, size, text or media source, typography (font_size, font_family, font_weight, text_align, letter_spacing, line_height) and layout state (rotation, opacity, z_index, visible, locked, parent_id). Values are returned EXACTLY as stored, in the element's own units — letter_spacing is in em, line_height is a multiplier — so read them rather than inferring type size or tracking from box geometry. parent_id means the element is in a group and its x/y are relative to that group, not the page. Fields an element does not carry are omitted. Use this before update_element — the ids it returns are what that tool takes. Returns a summary, not the full design file; large designs are capped and say so.

get_project_elements

Read one support ticket in full, with its timeline: status and assignment changes, internal notes, and the fact that customer emails were exchanged. Message bodies are scrubbed of one-time codes and tokens before they leave the workspace.

get_ticket

Add a file to the workspace media library (DAM) by giving Automo a URL to fetch — the right way to bring in video and other large media, since no bytes pass through the model. Automo downloads the file server-side (up to 100 MB; http(s) only, public URLs only) and stores it. iPhone-only formats are converted on the way in (HEIC becomes JPEG, HEVC becomes H.264; already-playable files are stored unchanged) — so importing an existing DAM file's own url is also how you convert one a user uploaded by hand (look for format_warning on list_files / search_dam_assets results). Pass mime_type when the URL has no file extension. Returns the stored file's id and public URL, usable directly in create_video_project scenes. For files above 100 MB use create_upload_url.

import_asset_from_url

Re-sync the speaker's mouth in EXISTING footage to a NEW audio track (a recorded voiceover, a translated dub, a cleaner take) — the fix for replaced clip audio where the on-camera lips no longer match. COSTS CREDITS and is consent-gated exactly like generate_video_clip: a call WITHOUT user_approved returns the credit estimate and charges nothing; show the user the cost and only call again with user_approved: true after they explicitly agree. Inputs come from the media library (asset ids from list_files / get_video_generation) or https URLs. The source video should be a single continuous shot of one visible speaker, 2–30 seconds. Returns a job_id — poll get_video_generation (takes 1–5 minutes); the synced clip lands in the media library ready to place on the timeline.

lip_sync_video

List the workspace's Automo Connect campaign briefs (outreach campaigns across social, email and WhatsApp), newest first. Returns id, name, status, target platforms and audience.

list_campaigns

List comments a user left anchored to spots in a project — a time on a video timeline, a cell in a spreadsheet, a paragraph in a document, or an element/region on a design/website/email. Reads the editor's own comment store, so it returns exactly what the user sees in the editor. Each comment has an `anchor` (where it applies) and a `body` (the requested change). Defaults to open (unresolved) top-level comments, most recent first. Enumerate these, implement each with the matching editor update tool, then call resolve_project_comment.

list_project_comments

List the workspace's brand kits. The default kit (is_default) is returned first. Use get_brand_kit for a kit's colors, fonts and logos.

list_brand_kits

List your own calendar events in a time range, earliest first — both the ones you organise and the ones you were invited to and have not declined. Use it to answer "what's on today" or to look up what a meeting was about. Only your calendar is readable — not colleagues'. To propose a time, prefer find_free_time.

list_calendar_events

List the workspace's chat channels (excluding direct messages). Optionally filter by a name search. Returns id, name, type and last activity.

list_chats

List deals in the workspace CRM, newest first. Filter by stage, by whether they are still open, or to one company or contact. Returns value, currency, stage, probability and expected close date.

list_deals

List the workspace's design, website, email and photo projects (the canvas editors), most recently edited first. Returns each project's id, name, type, updated_at, thumbnail_url and an edit_url that opens it in the right Automo editor. For VIDEO, SPREADSHEET or DOCUMENT projects use list_video_projects / list_spreadsheets / list_documents instead. Use get_project_elements to read a design's canvas.

list_projects