For AI agents: markdown of this page — /docs-content-en/entities/call-lists/create.md documentation index — /llms.txt

Create a call list

POST /v1/call-lists

Bitrix24 API: crm.calllist.add

Scope: crm

entityType is CONTACT or COMPANY; entities is a nonempty array of positive IDs; webformId is an optional positive ID. Bitrix24 checks existence and permissions. Missing participants or forms return 422 BITRIX_ERROR with the platform refusal text. If every participant is inaccessible, the response is 403 BITRIX_ACCESS_DENIED. Post-write readback returns skipped IDs absent from the visible participant set. Creation also creates a call activity. If readback fails, the list may already exist; do not blindly retry POST.

JSON

{
  "entityType": "CONTACT",
  "entities": [
    37,
    245
  ]
}

JSON

{
  "success": true,
  "data": {
    "id": 10,
    "skipped": []
  }
}

READONLY keys may read; POST and PUT return 403 WRITE_BLOCKED_READONLY_KEY. Other platform business refusals return 422 BITRIX_ERROR.