Create chatbot

Create a new chatbot programmatically. It will be automatically assigned to the project associated with your API key.

POST/chatbots

Request parameters

Body

namestringrequired

The name of your new chatbot.

settingsobject

Initial configuration object for your bot, such as theme and prompt details. Leave blank for defaults.

Headers

Authorizationstringrequired

Your API Key formatted as Bearer sk_live_…

Response

dataobject

The newly created chatbot object.

idstring

The unique UUID identifier of the chatbot.

namestring

The name of the chatbot.

settingsobject

Configuration object containing theme and prompt details.

is_activeboolean

Whether the chatbot is currently enabled and active.

created_atstring

The ISO 8601 timestamp of when the chatbot was created.

cURL

curl -X POST https://app.picobot.dev/api/chatbots \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"name": "My New Bot", "settings": {"theme": "dark"}}'

Node.js

fetch('https://app.picobot.dev/api/chatbots', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: 'My New Bot',
    settings: { theme: 'dark' }
  })
})
.then(res => res.json())
.then(console.log);

Python

import requests

headers = {
    "Authorization": "Bearer <token>"
}
json_data = {
    "name": "My New Bot",
    "settings": {
        "theme": "dark"
    }
}
response = requests.post("https://app.picobot.dev/api/chatbots", headers=headers, json=json_data)
print(response.json())

Java

HttpResponse<String> response = Unirest.post("https://app.picobot.dev/api/chatbots")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\"name\": \"My New Bot\", \"settings\": {\"theme\": \"dark\"}}")
  .asString();

{
  "data": {
    "id": "91981020-f783-4544-ad96-39857ac589cb",
    "name": "My New Bot",
    "settings": {
      "theme": "dark"
    },
    "is_active": true,
    "created_at": "2026-06-19T21:21:06.572Z"
  }
}