Upload an existing file to Macro from base64-encoded bytes, up to 25 MiB decoded. Use for PDFs, images, Office files, and other files; use CreateDocument for generated text or native Macro spreadsheets. Encode actual file bytes programmatically; never invent or transcribe binary content. Returns a document ID after the bytes are uploaded; preview and indexing may finish asynchronously. Does not read local paths or fetch URLs.
Filename including its extension, for example report.pdf. Do not include a directory path.
contentBase64
string
Yes
Standard padded base64 of the exact file bytes (maximum 25 MiB decoded). No data URL prefix or whitespace. Prefer constructing this argument programmatically from the file.
projectId
string
No
Optional destination project (folder) ID. Requires edit access. Omit to upload to the user’s top-level files.
⌘I
{"docsConfig":{"theme":"maple","$schema":"https://mintlify.com/docs.json","name":"Macro","description":"Product and technical documentation for Macro, the unified interface for email, messages, tasks, calls, agents, pull requests, docs, CRM — linked together with shared AI memory.","colors":{"primary":"#000000","light":"#ffffff","dark":"#000000"},"logo":{"light":"https://mintcdn.com/macro-a2d84caa/hHOXgcdCjBAaCcmP/logo/light.svg?fit=max\u0026auto=format\u0026n=hHOXgcdCjBAaCcmP\u0026q=85\u0026s=4f2be14c1f50d4339ee013aeeb1b11e9","dark":"https://mintcdn.com/macro-a2d84caa/hHOXgcdCjBAaCcmP/logo/dark.svg?fit=max\u0026auto=format\u0026n=hHOXgcdCjBAaCcmP\u0026q=85\u0026s=70107b68de1fa8c26acfac75dbdd9e01"},"favicon":"https://mintcdn.com/macro-a2d84caa/hHOXgcdCjBAaCcmP/favicon.svg?fit=max\u0026auto=format\u0026n=hHOXgcdCjBAaCcmP\u0026q=85\u0026s=f8c739e97fea6c138b93df62734ee836","appearance":{"default":"system","strict":true},"background":{"color":{"light":"#f5f1e8","dark":"#000000"}},"navbar":{"primary":{"type":"button","label":"Get Macro","href":"https://macro.com"}},"fonts":{"heading":{"family":"Roboto Slab","source":"fonts/roboto-slab-variable.woff2","format":"woff2"},"body":{"family":"Inter","source":"fonts/inter-variable.woff2","format":"woff2"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"macro-a2d84caa","hasAudioNarration":false,"actualSubdomain":"macro-a2d84caa","customDomains":["docs.macro.com"],"gitSource":{"type":"github","owner":"macro-inc","repo":"macro","deployBranch":"main","contentDirectory":"apps/docs","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6aecc1e5dab9b27b24422efa","collectionId":"58802fa6-05dd-46ef-ac4f-9a50c68a5e0b","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6aecc1e5dab9b27b24422efa"},"entitlements":{},"buildId":"6aed2d5670443fed9ef7b6e5","clientVersion":"0.0.4074","searchFilterCounts":[{"language":"default","tag":"Agents","count":172},{"language":"default","tag":"Tool Reference","count":167},{"language":"default","tag":"Blocks","count":15},{"language":"default","tag":"Changelog","count":7},{"language":"default","tag":"2026","count":5},{"language":"default","tag":"Drive","count":5},{"language":"default","tag":"Features","count":4},{"language":"default","tag":"Account","count":3},{"language":"default","tag":"Key Concepts","count":3},{"language":"default","tag":"2025","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","href":"/_mintlify/custom/macro-a2d84caa/148e0bc7475dbc96/style.css"}],"page":{"pagePath":"AI/mcp/tools/upload-file","slug":"/AI/mcp/tools/upload-file","pageMetadata":{"title":"UploadFile","description":"Upload an existing file to Macro from base64-encoded bytes, up to 25 MiB decoded.","href":"/AI/mcp/tools/upload-file"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Upload an existing file to Macro from base64-encoded bytes, up to 25 MiB decoded.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,p:`p`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{Heading,Table}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`1`,id:`uploadfile`,children:`UploadFile`}),`\n`,_jsx(_components.p,{children:`Upload an existing file to Macro from base64-encoded bytes, up to 25 MiB decoded. Use for PDFs, images, Office files, and other files; use CreateDocument for generated text or native Macro spreadsheets. Encode actual file bytes programmatically; never invent or transcribe binary content. Returns a document ID after the bytes are uploaded; preview and indexing may finish asynchronously. Does not read local paths or fetch URLs.`}),`\n`,_jsx(Heading,{level:`2`,id:`parameters`,children:`Parameters`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Parameter`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Required`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`fileName`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Yes`}),_jsx(_components.td,{children:`Filename including its extension, for example report.pdf. Do not include a directory path.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`contentBase64`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Yes`}),_jsx(_components.td,{children:`Standard padded base64 of the exact file bytes (maximum 25 MiB decoded). No data URL prefix or whitespace. Prefer constructing this argument programmatically from the file.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`projectId`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`Optional destination project (folder) ID. Requires edit access. Omit to upload to the user’s top-level files.`})]})]})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"UploadFile","description":"Upload an existing file to Macro from base64-encoded bytes, up to 25 MiB decoded.","href":"/AI/mcp/tools/upload-file"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"UploadFile","slug":"uploadfile","depth":1,"children":[]},{"title":"Parameters","slug":"parameters","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"macro-a2d84caa","siteName":"Macro","title":"UploadFile - Macro","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-02T22:33:27.670Z","originalFileLocation":"AI/mcp/tools/upload-file.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"system\";if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Upload an existing file to Macro from base64-encoded bytes, up to 25 MiB decoded.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Macro\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/macro-a2d84caa/RngrnyM0xCQFDfCn/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/macro-a2d84caa/RngrnyM0xCQFDfCn/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/macro-a2d84caa/RngrnyM0xCQFDfCn/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/macro-a2d84caa/RngrnyM0xCQFDfCn/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/macro-a2d84caa/RngrnyM0xCQFDfCn/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/macro-a2d84caa/RngrnyM0xCQFDfCn/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/macro-a2d84caa/RngrnyM0xCQFDfCn/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/macro-a2d84caa/RngrnyM0xCQFDfCn/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/macro-a2d84caa/RngrnyM0xCQFDfCn/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"UploadFile - Macro\">\u003cmeta data-mint-head property=\"og:description\" content=\"Upload an existing file to Macro from base64-encoded bytes, up to 25 MiB decoded.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Macro\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.macro.com/AI/mcp/tools/upload-file\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://macro-a2d84caa.mintlify.site/_mintlify/api/og/v2?division=Tool+Reference\u0026amp;title=UploadFile\u0026amp;description=Upload+an+existing+file+to+Macro+from+base64-encoded+bytes%2C+up+to+25+MiB+decoded.\u0026amp;theme=dca699529d18a4c0efe8a3d4\u0026amp;signature=e8e7dee08ba2e28c2d0ac3c96111f097a2291b1e0576025abca83ee42d6c08d6\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"UploadFile - Macro\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Upload an existing file to Macro from base64-encoded bytes, up to 25 MiB decoded.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://macro-a2d84caa.mintlify.site/_mintlify/api/og/v2?division=Tool+Reference\u0026amp;title=UploadFile\u0026amp;description=Upload+an+existing+file+to+Macro+from+base64-encoded+bytes%2C+up+to+25+MiB+decoded.\u0026amp;theme=dca699529d18a4c0efe8a3d4\u0026amp;signature=e8e7dee08ba2e28c2d0ac3c96111f097a2291b1e0576025abca83ee42d6c08d6\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/macro-a2d84caa/RngrnyM0xCQFDfCn/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Macro\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#000000\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.macro.com/AI/mcp/tools/upload-file\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/AI/mcp/tools/upload-file.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.macro.com/#organization\",\"name\":\"Macro\",\"url\":\"https://docs.macro.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/macro-a2d84caa/hHOXgcdCjBAaCcmP/logo/light.svg?fit=max\u0026auto=format\u0026n=hHOXgcdCjBAaCcmP\u0026q=85\u0026s=4f2be14c1f50d4339ee013aeeb1b11e9\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.macro.com#website\",\"name\":\"Macro\",\"url\":\"https://docs.macro.com\",\"publisher\":{\"@id\":\"https://docs.macro.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.macro.com/AI/mcp/tools/upload-file#webpage\",\"url\":\"https://docs.macro.com/AI/mcp/tools/upload-file\",\"name\":\"UploadFile\",\"description\":\"Upload an existing file to Macro from base64-encoded bytes, up to 25 MiB decoded.\",\"dateModified\":\"2026-10-02T22:33:27.670Z\",\"isPartOf\":{\"@id\":\"https://docs.macro.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.macro.com/AI/mcp/tools/upload-file#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.macro.com/AI/mcp/tools/upload-file#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Agents\",\"item\":\"https://docs.macro.com/AI/bring-your-own\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Tool Reference\",\"item\":\"https://docs.macro.com/AI/mcp/tools/index\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"UploadFile\",\"item\":\"https://docs.macro.com/AI/mcp/tools/upload-file\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.macro.com/AI/mcp/tools/upload-file#article\",\"headline\":\"UploadFile\",\"name\":\"UploadFile\",\"description\":\"Upload an existing file to Macro from base64-encoded bytes, up to 25 MiB decoded.\",\"url\":\"https://docs.macro.com/AI/mcp/tools/upload-file\",\"mainEntityOfPage\":{\"@id\":\"https://docs.macro.com/AI/mcp/tools/upload-file#webpage\"},\"dateModified\":\"2026-10-02T22:33:27.670Z\",\"publisher\":{\"@id\":\"https://docs.macro.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.macro.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Macro\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Macro","nav":{"global":null,"pages":[{"title":"Welcome to Macro","icon":"house","href":"/index"},{"title":"Getting started","icon":"rocket","href":"/getting-started"},{"title":"Switch to Macro","icon":"arrow-right-arrow-left","href":"/switch-to-macro"},{"title":"Get the App","icon":"display","href":"/apps"},{"group":"Features","pages":[{"title":"Unified Search","icon":"magnifying-glass","href":"/product/search"},{"title":"Unified Memory","icon":"brain","href":"/product/unified-memory"},{"title":"Unified Tagging","icon":"tag","href":"/product/tagging"},{"title":"Unified Sharing","icon":"share","href":"/product/sharing"}]},{"group":"Blocks","pages":[{"title":"Home","icon":"house","href":"/product/home"},{"group":"Drive","icon":"folder","root":{"title":"Drive","icon":"folder","href":"/product/drive"},"pages":[{"title":"Documents","icon":"file","href":"/product/docs"},{"title":"Spreadsheets","icon":"table","href":"/product/spreadsheets"},{"title":"Canvas","icon":"shapes","href":"/product/canvas"},{"title":"Snippets","icon":"brackets-curly","href":"/product/snippets"},{"title":"Databases","icon":"database","href":"/product/databases"}]},{"title":"Email","icon":"envelope","href":"/product/email"},{"title":"Chat","icon":"comment","href":"/product/channels"},{"group":"Tasks","icon":"square-check","root":{"title":"Tasks","icon":"square-check","href":"/product/tasks"},"pages":[{"title":"Projects","icon":"layer-group","href":"/product/projects"}]},{"group":"Calendar","icon":"calendar","root":{"title":"Calendar","icon":"calendar","href":"/product/calendar"},"pages":[{"title":"Booking links","icon":"calendar-check","href":"/product/booking-links"}]},{"group":"Agents","icon":"sparkle","root":{"title":"Agents","icon":"sparkle","href":"/product/agents"},"pages":[{"title":"Routines","icon":"clock","href":"/product/routines"},{"title":"Skills","icon":"pen-ruler","href":"/product/skills"}]},{"title":"Customers","icon":"buildings","href":"/product/crm"},{"title":"Calls","icon":"phone-volume","href":"/product/calls"},{"title":"Reviews","icon":"code-pull-request","href":"/product/reviews"}]},{"group":"Key Concepts","pages":[{"title":"Mentions","icon":"at","href":"/concepts/mentions"},{"title":"Properties","icon":"tags","href":"/concepts/properties"},{"title":"Permissions","icon":"lock","href":"/permissions"}]},{"group":"Agents","pages":[{"title":"Bring your own agent","sidebarTitle":"Bring your own agent","icon":"terminal","href":"/AI/bring-your-own"},{"title":"Cursor","sidebarTitle":"Cursor","icon":"code","href":"/AI/cursor"},{"title":"MCP Setup","icon":"plug","href":"/AI/mcp/overview"},{"group":"Tool Reference","icon":"wrench","pages":[{"title":"Tool Reference","href":"/AI/mcp/tools/index"},{"title":"AddSharedCalendarEvent","href":"/AI/mcp/tools/add-shared-calendar-event"},{"title":"AddToPipeline","href":"/AI/mcp/tools/add-to-pipeline"},{"title":"ApplyCanvasEdits","href":"/AI/mcp/tools/apply-canvas-edits"},{"title":"BashCodeExecution","href":"/AI/mcp/tools/bash-code-execution"},{"title":"BulkSetEntityPropertyOptions","href":"/AI/mcp/tools/bulk-set-entity-property-options"},{"title":"CalculateSpreadsheet","href":"/AI/mcp/tools/calculate-spreadsheet"},{"title":"ChangeBooking","href":"/AI/mcp/tools/change-booking"},{"title":"Comment","href":"/AI/mcp/tools/comment"},{"title":"CommentOnText","href":"/AI/mcp/tools/comment-on-text"},{"title":"ConfigureAgent","href":"/AI/mcp/tools/configure-agent"},{"title":"ConfigureBot","href":"/AI/mcp/tools/configure-bot"},{"title":"ContentSearch","href":"/AI/mcp/tools/content-search"},{"title":"CreateAgentSession","href":"/AI/mcp/tools/create-agent-session"},{"title":"CreateBookingLink","href":"/AI/mcp/tools/create-booking-link"},{"title":"CreateBot","href":"/AI/mcp/tools/create-bot"},{"title":"CreateCalendarEvent","href":"/AI/mcp/tools/create-calendar-event"},{"title":"CreateChannel","href":"/AI/mcp/tools/create-channel"},{"title":"CreateChannelMediaUpload","href":"/AI/mcp/tools/create-channel-media-upload"},{"title":"CreateCompany","href":"/AI/mcp/tools/create-company"},{"title":"CreateContact","href":"/AI/mcp/tools/create-contact"},{"title":"CreateDocument","href":"/AI/mcp/tools/create-document"},{"title":"CreateForm","href":"/AI/mcp/tools/create-form"},{"title":"CreateImportEntity","href":"/AI/mcp/tools/create-import-entity"},{"title":"CreateInitiative","href":"/AI/mcp/tools/create-initiative"},{"title":"CreatePipeline","href":"/AI/mcp/tools/create-pipeline"},{"title":"CreateProject","href":"/AI/mcp/tools/create-project"},{"title":"CreateRoutine","href":"/AI/mcp/tools/create-routine"},{"title":"CreateSkill","href":"/AI/mcp/tools/create-skill"},{"title":"CreateTag","href":"/AI/mcp/tools/create-tag"},{"title":"Decide","href":"/AI/mcp/tools/decide"},{"title":"DeleteBot","href":"/AI/mcp/tools/delete-bot"},{"title":"DeleteCalendarEvent","href":"/AI/mcp/tools/delete-calendar-event"},{"title":"DeleteCallRecord","href":"/AI/mcp/tools/delete-call-record"},{"title":"DeleteChannelMessage","href":"/AI/mcp/tools/delete-channel-message"},{"title":"DeleteComment","href":"/AI/mcp/tools/delete-comment"},{"title":"DeleteDatabaseView","href":"/AI/mcp/tools/delete-database-view"},{"title":"DeleteImportEntity","href":"/AI/mcp/tools/delete-import-entity"},{"title":"DeleteInitiative","href":"/AI/mcp/tools/delete-initiative"},{"title":"DeleteRoutine","href":"/AI/mcp/tools/delete-routine"},{"title":"DeleteTag","href":"/AI/mcp/tools/delete-tag"},{"title":"DescribeDatabase","href":"/AI/mcp/tools/describe-database"},{"title":"DispatchCodingAgent","href":"/AI/mcp/tools/dispatch-coding-agent"},{"title":"DuplicateItem","href":"/AI/mcp/tools/duplicate-item"},{"title":"EditBookingLink","href":"/AI/mcp/tools/edit-booking-link"},{"title":"EditCanvas","href":"/AI/mcp/tools/edit-canvas"},{"title":"EditChannelMessage","href":"/AI/mcp/tools/edit-channel-message"},{"title":"EditComment","href":"/AI/mcp/tools/edit-comment"},{"title":"EditDocument","href":"/AI/mcp/tools/edit-document"},{"title":"EditForm","href":"/AI/mcp/tools/edit-form"},{"title":"EditPipeline","href":"/AI/mcp/tools/edit-pipeline"},{"title":"EditPresentation","href":"/AI/mcp/tools/edit-presentation"},{"title":"EditSpreadsheet","href":"/AI/mcp/tools/edit-spreadsheet"},{"title":"EditTag","href":"/AI/mcp/tools/edit-tag"},{"title":"EditWordDocument","href":"/AI/mcp/tools/edit-word-document"},{"title":"ExportPipelineCsv","href":"/AI/mcp/tools/export-pipeline-csv"},{"title":"FindPipelineEntries","href":"/AI/mcp/tools/find-pipeline-entries"},{"title":"GenerateImage","href":"/AI/mcp/tools/generate-image"},{"title":"GenerateObject","href":"/AI/mcp/tools/generate-object"},{"title":"GetBookingInsights","href":"/AI/mcp/tools/get-booking-insights"},{"title":"GetBookingRescheduleSlots","href":"/AI/mcp/tools/get-booking-reschedule-slots"},{"title":"GetBotWebhooks","href":"/AI/mcp/tools/get-bot-webhooks"},{"title":"GetCompany","href":"/AI/mcp/tools/get-company"},{"title":"GetEntityProperties","href":"/AI/mcp/tools/get-entity-properties"},{"title":"GetTeamAvailability","href":"/AI/mcp/tools/get-team-availability"},{"title":"GetThread","href":"/AI/mcp/tools/get-thread"},{"title":"GetUserActivity","href":"/AI/mcp/tools/get-user-activity"},{"title":"ImportCompaniesCsv","href":"/AI/mcp/tools/import-companies-csv"},{"title":"ImportFromJira","href":"/AI/mcp/tools/import-from-jira"},{"title":"ImportFromLinear","href":"/AI/mcp/tools/import-from-linear"},{"title":"ImportFromNotion","href":"/AI/mcp/tools/import-from-notion"},{"title":"ImportNotionPage","href":"/AI/mcp/tools/import-notion-page"},{"title":"ImportPipelineCsv","href":"/AI/mcp/tools/import-pipeline-csv"},{"title":"IssueBotCredential","href":"/AI/mcp/tools/issue-bot-credential"},{"title":"ListAgents","href":"/AI/mcp/tools/list-agents"},{"title":"ListAgentUpdates","href":"/AI/mcp/tools/list-agent-updates"},{"title":"ListBookingLinks","href":"/AI/mcp/tools/list-booking-links"},{"title":"ListBookings","href":"/AI/mcp/tools/list-bookings"},{"title":"ListBots","href":"/AI/mcp/tools/list-bots"},{"title":"ListCalendarEvents","href":"/AI/mcp/tools/list-calendar-events"},{"title":"ListCalendars","href":"/AI/mcp/tools/list-calendars"},{"title":"ListCodingAgents","href":"/AI/mcp/tools/list-coding-agents"},{"title":"ListCompanies","href":"/AI/mcp/tools/list-companies"},{"title":"ListDatabases","href":"/AI/mcp/tools/list-databases"},{"title":"ListEntities","href":"/AI/mcp/tools/list-entities"},{"title":"ListForms","href":"/AI/mcp/tools/list-forms"},{"title":"ListImportEntities","href":"/AI/mcp/tools/list-import-entities"},{"title":"ListInboxes","href":"/AI/mcp/tools/list-inboxes"},{"title":"ListInitiatives","href":"/AI/mcp/tools/list-initiatives"},{"title":"ListLabels","href":"/AI/mcp/tools/list-labels"},{"title":"ListNotifications","href":"/AI/mcp/tools/list-notifications"},{"title":"ListPipelines","href":"/AI/mcp/tools/list-pipelines"},{"title":"ListRoutines","href":"/AI/mcp/tools/list-routines"},{"title":"ListSkills","href":"/AI/mcp/tools/list-skills"},{"title":"ListTags","href":"/AI/mcp/tools/list-tags"},{"title":"ListTeamMembers","href":"/AI/mcp/tools/list-team-members"},{"title":"ManageAgentSession","href":"/AI/mcp/tools/manage-agent-session"},{"title":"ManageBotChannelAccess","href":"/AI/mcp/tools/manage-bot-channel-access"},{"title":"ManageChannelParticipants","href":"/AI/mcp/tools/manage-channel-participants"},{"title":"MarkNotificationsDone","href":"/AI/mcp/tools/mark-notifications-done"},{"title":"MarkNotificationsSeen","href":"/AI/mcp/tools/mark-notifications-seen"},{"title":"MoveToProject","href":"/AI/mcp/tools/move-to-project"},{"title":"MoveToTrash","href":"/AI/mcp/tools/move-to-trash"},{"title":"MuteNotifications","href":"/AI/mcp/tools/mute-notifications"},{"title":"NameSearch","href":"/AI/mcp/tools/name-search"},{"title":"OpenDirectMessage","href":"/AI/mcp/tools/open-direct-message"},{"title":"QueryDatabase","href":"/AI/mcp/tools/query-database"},{"title":"ReactToChannelMessage","href":"/AI/mcp/tools/react-to-channel-message"},{"title":"ReadActivity","href":"/AI/mcp/tools/read-activity"},{"title":"ReadAgentSession","href":"/AI/mcp/tools/read-agent-session"},{"title":"ReadAgentSessionSharing","href":"/AI/mcp/tools/read-agent-session-sharing"},{"title":"ReadBookingSettings","href":"/AI/mcp/tools/read-booking-settings"},{"title":"ReadCalendarEvent","href":"/AI/mcp/tools/read-calendar-event"},{"title":"ReadCallRecord","href":"/AI/mcp/tools/read-call-record"},{"title":"ReadCanvas","href":"/AI/mcp/tools/read-canvas"},{"title":"ReadChannelMessageContext","href":"/AI/mcp/tools/read-channel-message-context"},{"title":"ReadChannelMessages","href":"/AI/mcp/tools/read-channel-messages"},{"title":"ReadChannelThread","href":"/AI/mcp/tools/read-channel-thread"},{"title":"ReadContent","href":"/AI/mcp/tools/read-content"},{"title":"ReadDesign","href":"/AI/mcp/tools/read-design"},{"title":"ReadDiscussion","href":"/AI/mcp/tools/read-discussion"},{"title":"ReadForm","href":"/AI/mcp/tools/read-form"},{"title":"ReadIllustratorDocument","href":"/AI/mcp/tools/read-illustrator-document"},{"title":"ReadInitiative","href":"/AI/mcp/tools/read-initiative"},{"title":"ReadInitiativeActivity","href":"/AI/mcp/tools/read-initiative-activity"},{"title":"ReadMemory","href":"/AI/mcp/tools/read-memory"},{"title":"ReadMetadata","href":"/AI/mcp/tools/read-metadata"},{"title":"ReadPhotoshopDocument","href":"/AI/mcp/tools/read-photoshop-document"},{"title":"ReadPresentation","href":"/AI/mcp/tools/read-presentation"},{"title":"ReadProject","href":"/AI/mcp/tools/read-project"},{"title":"ReadRoutine","href":"/AI/mcp/tools/read-routine"},{"title":"ReadSkill","href":"/AI/mcp/tools/read-skill"},{"title":"ReadSpreadsheet","href":"/AI/mcp/tools/read-spreadsheet"},{"title":"ReadWordDocument","href":"/AI/mcp/tools/read-word-document"},{"title":"RemoveFromPipeline","href":"/AI/mcp/tools/remove-from-pipeline"},{"title":"RenameChannel","href":"/AI/mcp/tools/rename-channel"},{"title":"RenameDocument","href":"/AI/mcp/tools/rename-document"},{"title":"RenameItem","href":"/AI/mcp/tools/rename-item"},{"title":"RenderCanvas","href":"/AI/mcp/tools/render-canvas"},{"title":"ResolveComment","href":"/AI/mcp/tools/resolve-comment"},{"title":"RunRoutine","href":"/AI/mcp/tools/run-routine"},{"title":"SaveDatabaseQuery","href":"/AI/mcp/tools/save-database-query"},{"title":"SaveDatabaseView","href":"/AI/mcp/tools/save-database-view"},{"title":"SearchSkills","href":"/AI/mcp/tools/search-skills"},{"title":"SelfKnowledge","href":"/AI/mcp/tools/self-knowledge"},{"title":"SendChannelMessage","href":"/AI/mcp/tools/send-channel-message"},{"title":"SetEntityProperty","href":"/AI/mcp/tools/set-entity-property"},{"title":"SetFavorite","href":"/AI/mcp/tools/set-favorite"},{"title":"SetFormAccess","href":"/AI/mcp/tools/set-form-access"},{"title":"SetSenderPolicy","href":"/AI/mcp/tools/set-sender-policy"},{"title":"ShareWithChannel","href":"/AI/mcp/tools/share-with-channel"},{"title":"Subagent","href":"/AI/mcp/tools/subagent"},{"title":"TextEditorCodeExecution","href":"/AI/mcp/tools/text-editor-code-execution"},{"title":"UpdateAgentSessionSharing","href":"/AI/mcp/tools/update-agent-session-sharing"},{"title":"UpdateBookingSettings","href":"/AI/mcp/tools/update-booking-settings"},{"title":"UpdateCalendarEvent","href":"/AI/mcp/tools/update-calendar-event"},{"title":"UpdateCallRecord","href":"/AI/mcp/tools/update-call-record"},{"title":"UpdateInitiative","href":"/AI/mcp/tools/update-initiative"},{"title":"UpdateInitiativeSharing","href":"/AI/mcp/tools/update-initiative-sharing"},{"title":"UpdateMemory","href":"/AI/mcp/tools/update-memory"},{"title":"UpdatePipelineEntries","href":"/AI/mcp/tools/update-pipeline-entries"},{"title":"UpdateRoutine","href":"/AI/mcp/tools/update-routine"},{"title":"UpdateSharing","href":"/AI/mcp/tools/update-sharing"},{"title":"UpdateThreadLabels","description":"Add or remove a single label from every message in a Gmail thread.","href":"/AI/mcp/tools/update-thread-labels"},{"title":"UploadFile","href":"/AI/mcp/tools/upload-file"},{"title":"WebFetch","description":"Read the text of one public web page as Markdown.","href":"/AI/mcp/tools/web-fetch"},{"title":"WebSearch","href":"/AI/mcp/tools/web-search"}]}]},{"group":"Integrations","pages":[{"title":"GitHub","icon":"github","href":"/integrations/github"}]},{"group":"Account","pages":[{"title":"Teams \u0026 Admin","icon":"users","href":"/account/teams"},{"title":"Billing \u0026 Plans","icon":"credit-card","href":"/account/billing"},{"title":"Security","icon":"shield-check","href":"/security"}]},{"title":"Get Support","icon":"headset","href":"/support"},{"title":"FAQ","icon":"circle-question","href":"/faq"},{"title":"Keyboard Shortcuts","icon":"keyboard","href":"/keyboard-shortcuts"},{"group":"Changelog","pages":[{"group":"Releases","pages":[{"title":"Changelog","icon":"clock-rotate-left","href":"/changelog/introduction"}]},{"group":"2026","pages":[{"title":"May 2026","href":"/changelog/2026-05"},{"title":"April 2026","href":"/changelog/2026-04"},{"title":"March 2026","href":"/changelog/2026-03"},{"title":"February 2026","href":"/changelog/2026-02"},{"title":"January 2026","href":"/changelog/2026-01"}]},{"group":"2025","pages":[{"title":"December 2025","href":"/changelog/2025-12"}]}]}]},"basePath":"","title":"UploadFile - Macro","buildId":"dpl_BLQvU86QFwq3AhPofSTw6q8dGWKm","deploymentId":"dpl_BLQvU86QFwq3AhPofSTw6q8dGWKm","dynamics":[],"chunks":[]}
