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.
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 Kuuumba 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 if mentioning this bot should open a sandboxed coding-agent session. Defaults to false. |