Start a new session with a coding or chat agent from ListAgents. Provide the agent botId and a self-contained initial prompt. The new session does not inherit this conversation. Returns its session ID after the first prompt is accepted, not completed work. Use ManageAgentSession to continue an existing session. Create once; do not automatically retry after an uncertain failure.
{"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":"#ff8f05","light":"#ff8f05","dark":"#ff8f05"},"logo":{"light":"https://mintcdn.com/macro-a2d84caa/sYcZCyXGSkKkhq6m/logo/light.svg?fit=max\u0026auto=format\u0026n=sYcZCyXGSkKkhq6m\u0026q=85\u0026s=7f0d7fc38976ee6c70ad69fd85b3ea74","dark":"https://mintcdn.com/macro-a2d84caa/sYcZCyXGSkKkhq6m/logo/dark.svg?fit=max\u0026auto=format\u0026n=sYcZCyXGSkKkhq6m\u0026q=85\u0026s=83ba9bff3c2c74fb5fba8189f53f955a"},"favicon":{"light":"https://mintcdn.com/macro-a2d84caa/TbohKtAUdQfmVsR2/favicon.svg?fit=max\u0026auto=format\u0026n=TbohKtAUdQfmVsR2\u0026q=85\u0026s=497a9ea592764acefc22fc12432daf87","dark":"https://mintcdn.com/macro-a2d84caa/TbohKtAUdQfmVsR2/favicon.svg?fit=max\u0026auto=format\u0026n=TbohKtAUdQfmVsR2\u0026q=85\u0026s=497a9ea592764acefc22fc12432daf87"},"appearance":{"default":"dark","strict":true},"background":{"color":{"dark":"#090909"}},"navbar":{"primary":{"type":"button","label":"Get Macro","href":"https://macro.com"}},"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":"6ad7b582424ba1dc0f43e51b","collectionId":"4f06ae73-b6ba-479d-8cf2-40db718df8e2","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ad7b582424ba1dc0f43e51b"},"entitlements":{},"buildId":"6ad7b582424ba1dc0f43e51b","clientVersion":"0.0.3902","searchFilterCounts":[{"language":"default","tag":"Agents","count":155},{"language":"default","tag":"Tool Reference","count":152},{"language":"default","tag":"Blocks","count":11},{"language":"default","tag":"Changelog","count":7},{"language":"default","tag":"2026","count":5},{"language":"default","tag":"Key Concepts","count":4},{"language":"default","tag":"Features","count":4},{"language":"default","tag":"Account","count":3},{"language":"default","tag":"2025","count":1},{"language":"default","tag":"Releases","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"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":"editor-v7-file-tree","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":"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":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-branches-v2-autocommit","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-branches-v2","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":"editor-private-page-search","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":"teamspace","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":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","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":"byok-sep-25","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":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"client-snapshot-docs-config","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}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"AI/mcp/tools/create-agent-session","slug":"/AI/mcp/tools/create-agent-session","pageMetadata":{"title":"CreateAgentSession","description":"Start a new session with a coding or chat agent from ListAgents.","href":"/AI/mcp/tools/create-agent-session"},"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: \"Start a new session with a coding or chat agent from ListAgents.\"\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:`createagentsession`,children:`CreateAgentSession`}),`\n`,_jsx(_components.p,{children:`Start a new session with a coding or chat agent from ListAgents. Provide the agent botId and a self-contained initial prompt. The new session does not inherit this conversation. Returns its session ID after the first prompt is accepted, not completed work. Use ManageAgentSession to continue an existing session. Create once; do not automatically retry after an uncertain failure.`}),`\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:`agentId`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Yes`}),_jsx(_components.td,{children:`Agent persona botId from ListAgents.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`prompt`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Yes`}),_jsx(_components.td,{children:`Complete initial task and relevant context.`})]})]})]})]})}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":"CreateAgentSession","description":"Start a new session with a coding or chat agent from ListAgents.","href":"/AI/mcp/tools/create-agent-session"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"CreateAgentSession","slug":"createagentsession","depth":1,"children":[]},{"title":"Parameters","slug":"parameters","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"macro-a2d84caa","siteName":"Macro","title":"CreateAgentSession - Macro","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-20T18:40:14.561Z","originalFileLocation":"AI/mcp/tools/create-agent-session.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"dark\";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=\"dark\"}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=\"Start a new session with a coding or chat agent from ListAgents.\">\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/oeN8zboryNCxE-Vd/_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/oeN8zboryNCxE-Vd/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/macro-a2d84caa/oeN8zboryNCxE-Vd/_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/oeN8zboryNCxE-Vd/_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/oeN8zboryNCxE-Vd/_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/oeN8zboryNCxE-Vd/_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/oeN8zboryNCxE-Vd/_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/oeN8zboryNCxE-Vd/_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/oeN8zboryNCxE-Vd/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"CreateAgentSession - Macro\">\u003cmeta data-mint-head property=\"og:description\" content=\"Start a new session with a coding or chat agent from ListAgents.\">\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/create-agent-session\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"CreateAgentSession - Macro\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Start a new session with a coding or chat agent from ListAgents.\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/macro-a2d84caa/oeN8zboryNCxE-Vd/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Macro\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#ff8f05\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.macro.com/AI/mcp/tools/create-agent-session\">\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/create-agent-session.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/sYcZCyXGSkKkhq6m/logo/light.svg?fit=max\u0026auto=format\u0026n=sYcZCyXGSkKkhq6m\u0026q=85\u0026s=7f0d7fc38976ee6c70ad69fd85b3ea74\"}},{\"@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/create-agent-session#webpage\",\"url\":\"https://docs.macro.com/AI/mcp/tools/create-agent-session\",\"name\":\"CreateAgentSession\",\"description\":\"Start a new session with a coding or chat agent from ListAgents.\",\"dateModified\":\"2026-10-20T18:40:14.561Z\",\"isPartOf\":{\"@id\":\"https://docs.macro.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.macro.com/AI/mcp/tools/create-agent-session#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.macro.com/AI/mcp/tools/create-agent-session#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Agents\",\"item\":\"https://docs.macro.com/AI/recipes\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Tool Reference\",\"item\":\"https://docs.macro.com/AI/mcp/tools/index\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"CreateAgentSession\",\"item\":\"https://docs.macro.com/AI/mcp/tools/create-agent-session\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.macro.com/AI/mcp/tools/create-agent-session#article\",\"headline\":\"CreateAgentSession\",\"name\":\"CreateAgentSession\",\"description\":\"Start a new session with a coding or chat agent from ListAgents.\",\"url\":\"https://docs.macro.com/AI/mcp/tools/create-agent-session\",\"mainEntityOfPage\":{\"@id\":\"https://docs.macro.com/AI/mcp/tools/create-agent-session#webpage\"},\"dateModified\":\"2026-10-20T18:40:14.561Z\",\"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":"Get 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 Inbox","icon":"inbox","href":"/product/inbox"},{"title":"Unified Search","icon":"magnifying-glass","href":"/product/search"},{"title":"Unified Memory","icon":"brain","href":"/product/unified-memory"},{"title":"Unified Tagging","icon":"tags","href":"/product/tagging"}]},{"group":"Blocks","pages":[{"title":"Agents","icon":"wand-magic-sparkles","href":"/product/agents"},{"title":"Email","icon":"envelope","href":"/product/email"},{"title":"Documents","icon":"file-lines","href":"/product/docs"},{"title":"Canvas","icon":"diagram-project","href":"/product/canvas"},{"title":"Tasks","icon":"list-check","href":"/product/tasks"},{"title":"Snippets","icon":"brackets-curly","href":"/product/snippets"},{"title":"Channels","icon":"hashtag","href":"/product/channels"},{"title":"Calls","icon":"phone","href":"/product/calls"},{"title":"Calendar","icon":"calendar","href":"/product/calendar"},{"title":"Folders","icon":"folder","href":"/product/folders"},{"title":"CRM","icon":"building","href":"/product/crm"}]},{"group":"Key Concepts","pages":[{"title":"Blocks","icon":"cubes","href":"/concepts/blocks"},{"title":"Mentions","icon":"at","href":"/concepts/mentions"},{"title":"Properties","icon":"tags","href":"/concepts/properties"},{"title":"Permissions","icon":"lock","href":"/permissions"}]},{"group":"Agents","pages":[{"title":"Agent recipes","icon":"book-open","href":"/AI/recipes"},{"title":"Bring your own agent","sidebarTitle":"Bring your own agent","icon":"terminal","tag":"Coming soon","href":"/AI/bring-your-own"},{"title":"MCP Setup","icon":"plug","href":"/AI/mcp/overview"},{"group":"Tool Reference","icon":"wrench","pages":[{"title":"Tool Reference","href":"/AI/mcp/tools/index"},{"title":"AddToPipeline","href":"/AI/mcp/tools/add-to-pipeline"},{"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":"CommentOnDocument","href":"/AI/mcp/tools/comment-on-document"},{"title":"ConfigureAgent","href":"/AI/mcp/tools/configure-agent"},{"title":"ConfigureBot","href":"/AI/mcp/tools/configure-bot"},{"title":"ContentSearch","description":"Search items by their content: document body text; email subject/body/sender/recipient/cc/bcc and the display names on those addresses; agent session messages; call transcripts.","href":"/AI/mcp/tools/content-search"},{"title":"CreateAgentSession","href":"/AI/mcp/tools/create-agent-session"},{"title":"CreateBookingLink","description":"Create a reusable booking page, not a calendar meeting.","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":"DeleteDatabaseView","href":"/AI/mcp/tools/delete-database-view"},{"title":"DeleteDocumentComment","href":"/AI/mcp/tools/delete-document-comment"},{"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":"EditChannelMessage","href":"/AI/mcp/tools/edit-channel-message"},{"title":"EditDocument","href":"/AI/mcp/tools/edit-document"},{"title":"EditDocumentComment","href":"/AI/mcp/tools/edit-document-comment"},{"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":"ImportCompaniesCsv","href":"/AI/mcp/tools/import-companies-csv"},{"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":"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":"ReadCallRecord","href":"/AI/mcp/tools/read-call-record"},{"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":"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":"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":"ResolveDocumentComment","href":"/AI/mcp/tools/resolve-document-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":"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","href":"/AI/mcp/tools/update-thread-labels"},{"title":"UploadFile","href":"/AI/mcp/tools/upload-file"},{"title":"WebFetch","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"}]}]}]},"title":"CreateAgentSession - Macro","buildId":"dpl_C3fsfi1EcrBns9Vx91gUSN1X3Hi4","deploymentId":"dpl_C3fsfi1EcrBns9Vx91gUSN1X3Hi4","dynamics":[],"chunks":[]}
