# CRM settings

The CRM mode determines whether leads are enabled. This section lets you check the CRM mode of your Bitrix24 account before building a scenario around leads.

You can also read and change CRM settings for the entire Bitrix24 account. READWRITE is required for a change. Send the complete JSON `value` matching `meta.schema`; a failed readback does not undo a successful write. Never retry blindly when the outcome is unknown. New setting methods require `crm 26.2000.0`; accounts without them receive `422 METHOD_NOT_YET_AVAILABLE` with `error.release`.

Bitrix24 API: `crm.settings.mode.get`, `crm.enum.settings.mode`, `crm.settings.list`, `crm.settings.get`, `crm.settings.set`

Scope: `crm`

## Operations

- [CRM mode](./crm-settings/mode.md) — `GET /v1/crm-settings/mode`

- [List CRM settings](./crm-settings/list.md) — `GET /v1/crm-settings`
- [Get a CRM setting](./crm-settings/get.md) — `GET /v1/crm-settings/:id`
- [Change a CRM setting](./crm-settings/update.md) — `PATCH /v1/crm-settings/:id`

## Key fields

| Field | Description |
|------|----------|
| `mode` | Current mode: `1` — Classic CRM with leads, `2` — Simple CRM without leads |
| `name` | Name of the current mode in the Bitrix24 account language |
| `modes` | All modes of the Bitrix24 account, each with `id` and `name`. The current one is the item whose `id` equals `mode` |

## Before you start

1. **The mode is read-only.** You cannot switch the mode via the API. A READONLY key is sufficient.
2. **Leads are available only in Classic CRM**, that is, when `mode` is `1`.
3. **Build conditions on the number.** `name` depends on the Bitrix24 account language, so compare `mode`.

## Typical scenario

1. Get the mode: [`GET /v1/crm-settings/mode`](./crm-settings/mode.md).
2. If `mode` is `1`, proceed to [leads](/docs/entities/leads). If `2`, build the scenario without leads.

## Limits

| Limit | Value |
|-------|----------|
| Pagination | none: the mode and the list of modes come in a single response |
| Request rate | shared across the Vibecode API — see [Limits and optimization](/docs/optimization) |

## See also

- [Leads](/docs/entities/leads)
- [CRM enums](/docs/entities/crm-enums)
- [API reference](/docs/api-reference)