# Экспорт рассылок
## Общий контракт постановки задачи экспорта

Общий контракт постановки задачи экспорта описан [здесь](https://developers.mindbox.ru/docs/%D0%BE%D0%B1%D1%89%D0%B8%D0%B9-%D0%BF%D1%80%D0%B8%D0%BD%D1%86%D0%B8%D0%BF-%D1%8D%D0%BA%D1%81%D0%BF%D0%BE%D1%80%D1%82%D0%BE%D0%B2) 

## Контракт экспорта рассылок

**Пример запроса** 

```json title="JSON"
https://api.mindbox.ru/v3/operations/sync?endpointId={endpointId}&operation={operation}

Accept: application/json
Content-Type: application/json
Authorization: SecretKey {Секретный ключ}

{
  "sinceDateTimeUtc": "<Начальная дата и время изменения рассылки (UTC, YYYY-MM-DD hh:mm)>",
  "tillDateTimeUtc": "<Конечная дата и время изменения рассылки невключительно (UTC, YYYY-MM-DD hh:mm)>"
}
```

Во входных параметрах можно указать:

* Дату "от" в формате UTC. Тогда в выгрузку попадут только рассылки, которые изменились или были созданы в системе после этой даты
* Дату "до" в формате UTC. Тогда в выгрузку попадут только рассылки, которые изменились или были созданы в системе до этой даты

## Формат выгружаемого файла

**Описание базовых полей экспорта**

```json title="JSON"
{
  "mailings": [
    {
      "name": "<Название рассылки>",
      "mailingUtmName": "<Название рассылки для использования в UTM метке>",
      "type": "<Тип рассылки>",
      "channel": "<Канал отправки рассылки>",
      "creationDateTimeUtc": "<Дата создания рассылки в системе в UTC>",
      "lastChangedDateTimeUtc": "<Дата последнего изменения рассылки в UTC>",
      "ids": {
        "systemName": "<Системное имя рассылки>",
        "id": "<Идентификатор Mindbox>"
      },
      "subscriptionTopic": {
        "name": "<Название тематики>",
        "ids": {
          "externalId": "<Системное имя тематики>"
        }
      },
      "folder": {
        "name": "<Название папки>",
        "ids": {
          "systemName": "<Системное имя папки>"
        }
      },
      "brand": {
        "name": "<Название бренда>",
        "ids": {
          "systemName": "<Системное имя бренда>"
        }
      },
      "utm": {
        "utmSource": "<Значение UTM-метки utm_source>",
        "utmMedium": "<Значение UTM-метки utm_medium>",
        "utmCampaign": "<Значение UTM-метки utm_campaign>",
        "utmContent": "<Значение UTM-метки utm_content>"
      },
      "tags": [
        {
          "name": "<Название тега>",
          "ids": {
            "systemName": "<Системное имя тега>"
          }
        },
        {
          "name": "<Название тега>",
          "ids": {
            "systemName": "<Системное имя тега>"
          }
        }
      ]
    }
  ]
}
```

Тип рассылки (`type`) может иметь три значения:

* `mass` - массовая рассылка
* `trigger` - триггерная рассылка
* `transaction` - транзакционная рассылка