---
title: "POST /networks/{networkId}/bots"
method: POST
path: "/networks/{networkId}/bots"
---

# POST /networks/{networkId}/bots

`POST /networks/{networkId}/bots`

Creates a new bot in a specified Wickr network. Bots are automated accounts that can send and receive messages, enabling integration with external systems and automation of tasks.

## Path parameters

- `networkId` string, required

## Request body

- object
  - `username` string, required — The username for the bot. This must be unique within the network and follow the network's naming conventions.
  - `displayName` string — The display name for the bot that will be visible to users in the network.
  - `groupId` string, required — The ID of the security group to which the bot will be assigned.
  - `challenge` string, password, required — The password for the bot account.

## Response `200`

Success

- CreateBotResponse
  - `message` string — A message indicating the result of the bot creation operation.
  - `botId` string, required — The unique identifier assigned to the newly created bot.
  - `networkId` string — The ID of the network where the bot was created.
  - `username` string — The username of the newly created bot.
  - `displayName` string — The display name of the newly created bot.
  - `groupId` string — The ID of the security group to which the bot was assigned.

## Other responses

- `480` — ValidationError
- `481` — BadRequestError
- `482` — ResourceNotFoundError
- `483` — ForbiddenError
- `484` — UnauthorizedError
- `485` — InternalServerError
- `486` — RateLimitError

---

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