Списки

Добавить контакты в список

Добавляет существующие контакты в указанный список. Несуществующие и недоступные ID контактов молча игнорируются. Поле affectedContacts содержит число реально добавленных контактов: контакты, уже состоявшие в списке, не учитываются.

post/v1/public/lists/{listId}/contacts/add

Request

Base URL: https://api.rusender.ru/api
URL: https://api.rusender.ru/api/v1/public/lists/{listId}/contacts/add
Auth: HTTP bearer

Path parameters

listIdinteger required

Уникальный идентификатор списка.

Headers

Idempotency-Keystring

Опциональный ключ идемпотентности. Если передан, повторные запросы с тем же ключом обрабатываются только один раз.

Request body

Example request

{
  "data": {
    "contactIds": [
      1,
      2,
      3
    ]
  }
}

Response

Контакты успешно добавлены.

okboolean required

Флаг успешного выполнения.

Example response

{
  "ok": true,
  "data": {
    "listId": 1,
    "affectedContacts": 3
  },
  "meta": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2026-03-05T12:00:00.000Z",
    "pagination": {
      "page": 1,
      "limit": 20,
      "totalItems": 150,
      "totalPages": 8
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.