Macro is a unified workspace for teams: email, chat, docs, tasks, agents, calls, and CRM — @-linked together with shared AI memory.
TypeScript agentaiai-agentsall-in-onecrmcrm-systememaillinearmcpmessagingnotesnotionofficerustslackslack-alternativestartupstartup-toolstypescriptworkspace
---
title: CreateBot
description: >-
Create a bot with a name, stable handle, and optional profile.
---
# CreateBot
Create a bot with a name, stable handle, and optional profile. Omit teamId for a bot owned by the current user; provide teamId to create a team-owned bot, which requires team administrator or owner permission. Pass channelId when the bot should post to a channel immediately: the current user must be a member of that channel. The response then includes that channel's webhook URL and a credential proposal. The user mints the bearer token from the chat card or bot settings; the secret is never returned in this tool result. Omit channelId to create the bot only, then use ManageBotChannelAccess and IssueBotCredential for later setup.
## Parameters
| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `teamId` | string | No | Team id that should own the bot. Omit for a bot owned by the current user. |
| `name` | string | Yes | Human-readable display name for the bot. |
| `handle` | string | Yes | Stable mention handle using only lowercase ASCII letters, digits, hyphens, and underscores; maximum 64 characters. |
| `description` | string | No | Optional short description of what the bot does. |
| `avatarUrl` | string | No | Optional URL for the bot profile picture. Pass the URL of an image already uploaded to Macro static files or another reachable image URL. |
| `channelId` | string | No | Channel id to grant the new bot access to. Requires current-user channel membership. When set, the tool also returns the channel webhook URL and a credential proposal the user can mint from the chat card. |
| `credentialLabel` | string | No | Optional label for the credential the user will mint when channelId is set, such as `github-webhook`. Requires channelId. |
| `credentialExpiresAt` | string | No | Optional RFC 3339 expiration for the credential the user will mint when channelId is set. Requires channelId. |
| `hasAgent` | boolean | No | Set true to make this bot an AI agent: mentions and DMs start an agent session. Defaults to false. |