---
title: "Set Settings"
method: POST
path: "/settings/set/{instance}"
tags: ["Settings Controller"]
---

# Set Settings

`POST /settings/set/{instance}`

## Request

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

Set settings

## Path parameters

- `instance` string, required

## Request body

- object
  - `rejectCall` boolean, required: Reject calls automatically
  - `msgCall` string, required: Message to be sent when a call is rejected automatically
  - `groupsIgnore` boolean, required: Ignore group messages
  - `alwaysOnline` boolean, required: Always show WhatsApp online
  - `readMessages` boolean, required: Send read receipts
  - `readStatus` boolean, required: See message status
  - `syncFullHistory` boolean, required: Syncronize full WhatsApp history with EvolutionAPI

## Response `201`

Created

- object
  - `settings` object
    - `instanceName` string: The name of the instance.
    - `settings` object
      - `reject_call` boolean: Indicates whether to reject incoming calls.
      - `groups_ignore` boolean: Indicates whether to ignore group messages.
      - `always_online` boolean: Indicates whether to always keep the instance online.
      - `read_messages` boolean: Indicates whether to mark messages as read.
      - `read_status` boolean: Indicates whether to read status updates.
      - `sync_full_history` boolean: Indicates whether to synchronize full message history.

## Changes

- **2024-11-25** (v2) `0666de64f49a`: 7 breaking, 7 warning
  - added the new required request property `alwaysOnline`
  - added the new required request property `groupsIgnore`
  - added the new required request property `msgCall`
  - added the new required request property `readMessages`
  - …10 more
- **2024-11-25** (v2) `c153448703e5`: 7 breaking, 6 info
  - added the new required request property `always_online`
  - added the new required request property `groups_ignore`
  - added the new required request property `read_messages`
  - added the new required request property `read_status`
  - …9 more
- **2024-09-09** (v2) `0c4620ca5ed5`: 1 breaking, 7 warning, 5 info
  - removed the success response with the status `201`
  - removed the request property `alwaysOnline`
  - removed the request property `groupsIgnore`
  - removed the request property `msgCall`
  - …9 more
- **2024-08-09** (v2) `996acfdb07ce`: 6 breaking, 13 warning, 8 info
  - added the new required request property `alwaysOnline`
  - added the new required request property `groupsIgnore`
  - added the new required request property `readMessages`
  - added the new required request property `readStatus`
  - …23 more

[Operation history](https://skmtc.dev/evolution-foundation/apis/evolution-api-3/changes/settings/set/: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)