# Call lists

Collect contacts or companies into a manager call list and inspect participant statuses.

Bitrix24 API: `crm.calllist.list`, `crm.calllist.get`, `crm.calllist.add`, `crm.calllist.update`, `crm.calllist.items.get`, `crm.calllist.statuslist`

Scope: `crm`

## Operations

- [List](./call-lists/list.md) — `GET /v1/call-lists`
- [Get](./call-lists/get.md) — `GET /v1/call-lists/:id`
- [Create](./call-lists/create.md) — `POST /v1/call-lists`
- [Replace participants](./call-lists/replace.md) — `PUT /v1/call-lists/:id`
- [Participants](./call-lists/items.md) — `GET /v1/call-lists/:id/items`
- [Statuses](./call-lists/statuses.md) — `GET /v1/call-lists/statuses`

## Call a segment

Get contacts through `GET /v1/contacts`, then pass their IDs to list creation. Read participants and match status to the status dictionary.

Bitrix24 immediately creates a call activity for the current user. Lists cannot be deleted through REST; DELETE is unavailable. Manage the activity through `/v1/activities`.

The dateCreate value uses `YYYY-MM-DD HH:mm:ss` without a timezone. Vibecode preserves the string without inventing an offset.