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

# Create Evolution Bot Settings

`POST /evolutionBot/settings/{instance}`

## Request

- Base URL: `https://evolution-example`
- URL: `https://evolution-example/evolutionBot/settings/{instance}`
- Auth: API key in header `apikey`

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-11-25** (v2) `c153448703e5`: 1 breaking
  - api path removed without deprecation
- **2024-09-09** (v2) `0c4620ca5ed5`: 1 info
  - endpoint added

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

---

[API](https://skmtc.dev/evolution-foundation/apis/evolution-api-3.md) - [All operations](https://skmtc.dev/evolution-foundation/apis/evolution-api-3/llms.txt) - [OpenAPI document](https://skmtc.dev/evolution-foundation/apis/evolution-api-3/revisions/153363ee7f38?raw)