---
title: "Create Evolution Bot Settings"
method: POST
path: "/evolutionBot/settings/{instance}"
tags: ["Evolution Bot Controller"]
---

# Create Evolution Bot Settings

`POST /evolutionBot/settings/{instance}`

Configure settings for an Evolution Bot.

## Path parameters

- `instance` string, required

## Request body

- object
  - `expire` number, required — Expiration time for the session (in seconds)
  - `keywordFinish` string, required — Keyword to terminate the session
  - `delayMessage` number, required — Delay time (in ms) for sending messages
  - `unknownMessage` string, required — Message displayed when an unknown input is received
  - `listeningFromMe` boolean, required — Listen to messages sent by the bot owner
  - `stopBotFromMe` boolean, required — Stop bot when the owner sends a message
  - `keepOpen` boolean, required — Keep the session open after processing messages
  - `debounceTime` number, required — Time delay to debounce messages
  - `ignoreJids` string[] — List of JIDs to ignore
  - `botIdFallback` string, required — Fallback bot ID to use

## Response `200`

Ok

## Changes

- **2024-11-25** (v2) `6d14e589f2c9` — 1 breaking, 1 info
  - removed the success response with the status `201`
  - added the success response with the status `200`
- **2024-11-25** (v2) `bfaf67aeaded` — 1 info
  - endpoint added
- **2024-10-14** (v2) `c153448703e5` — 1 breaking
  - api path removed without deprecation
- **2024-09-09** (v2) `0c4620ca5ed5` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/evolution-foundation/apis/openapi/changes/evolutionBot/settings/:instance/post.md)

---

[API](https://skmtc.dev/evolution-foundation/apis/openapi.md) · [All operations](https://skmtc.dev/evolution-foundation/apis/openapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/evolution-foundation/openapi/revisions/153363ee7f38/schema)