---
title: "POST /accounts/{accountId}/bots"
method: POST
path: "/accounts/{accountId}/bots"
---

# POST /accounts/{accountId}/bots

`POST /accounts/{accountId}/bots`

Creates a bot for an Amazon Chime Enterprise account.

## Path parameters

- `accountId` string, required

## Request body

- object
  - `DisplayName` string, password, required — The bot display name.
  - `Domain` string — The domain of the Amazon Chime Enterprise account.

## Response `201`

Success

- CreateBotResponse
  - `Bot` object — The bot details.
    - `BotId` string — The bot ID.
    - `UserId` string — The unique ID for the bot user.
    - `DisplayName` string, password — The bot display name.
    - `BotType` 'ChatBot' — The bot type.
    - `Disabled` boolean — When true, the bot is stopped from running in your account.
    - `CreatedTimestamp` string, date-time — The bot creation timestamp, in ISO 8601 format.
    - `UpdatedTimestamp` string, date-time — The updated bot timestamp, in ISO 8601 format.
    - `BotEmail` string, password — The bot email address.
    - `SecurityToken` string, password — The security token used to authenticate Amazon Chime with the outgoing event endpoint.

## Other responses

- `480` — ServiceUnavailableException
- `481` — ServiceFailureException
- `482` — ForbiddenException
- `483` — BadRequestException
- `484` — UnauthorizedClientException
- `485` — ResourceLimitExceededException
- `486` — NotFoundException
- `487` — ThrottledClientException

---

[API](https://skmtc.net/aws/apis/chime.md) · [All operations](https://skmtc.net/aws/apis/chime/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/chime/versions/40da18840201/schema)