Контакты

Создать контакт

Создаёт контакт или переиспользует существующий. Контакт ищется по email в пределах вашего аккаунта: если контакт с таким email уже существует, он переиспользуется, а name и phone из запроса игнорируются; иначе создаётся новый. Добавление в список идемпотентно (уже в списке — no-op). Переменные применяются в обоих случаях. Дубликат email никогда не является ошибкой. Флаг created в ответе различает эти два исхода.

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

Request

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

Path parameters

listIdinteger required

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

Headers

Idempotency-Keystring

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

Request body

Example request

{
  "data": {
    "email": "john@example.com",
    "name": "John Doe",
    "phone": "+79001234567",
    "variables": {
      "city": "Moscow"
    }
  }
}

Response

Контакт успешно создан.

okboolean required

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

Example response

{
  "ok": true,
  "data": {
    "id": 42,
    "email": "john@example.com",
    "name": "John Doe",
    "phone": "+79001234567",
    "status": "active",
    "listIds": [
      1,
      5
    ],
    "lists": [
      {
        "id": 1,
        "name": "Newsletter subscribers"
      }
    ],
    "variables": {
      "city": "Moscow",
      "birthday": "1990-05-15"
    },
    "createdAt": "2026-01-15T10:30:00.000Z",
    "updatedAt": "2026-03-01T14:00:00.000Z",
    "created": true
  },
  "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.