Контакты

Импорт контактов в список

Импортирует до 1000 контактов в указанный список. Неизвестные ключи переменных должны быть объявлены в спецификации variables для автосоздания.

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

Request

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

Path parameters

listIdinteger required

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

Headers

Idempotency-Keystring

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

Request body

Example request

{
  "data": {
    "rows": [
      {
        "email": "john@example.com",
        "name": "John Doe",
        "phone": "+79001234567",
        "variables": {
          "city": "Moscow"
        }
      }
    ],
    "variables": [
      {
        "key": "city",
        "name": "City",
        "type": "string"
      }
    ]
  }
}

Response

Импорт завершён. Результат содержит итоговую сводку.

okboolean required

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

Example response

{
  "ok": true,
  "data": {
    "processed": 100,
    "addedCount": 80,
    "updatedCount": 10,
    "duplicateCount": 5,
    "errorCount": 5,
    "errorsSample": [
      {
        "row": 3,
        "code": "UNKNOWN_CUSTOM_FIELD",
        "message": "Unknown variable key: unknown_key"
      }
    ]
  },
  "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.