---
title: "Create a new log."
method: POST
path: "/cm/v1/logs"
tags: ["Log"]
---

# Create a new log.

`POST /cm/v1/logs`

Create a new log.

## Query parameters

- `ad_account_id` string, required

## Request body

- DspLog — The metadata of a log.
  - `id` string — Unique identifier of the Log. Automatically set by server on creation.
  - `type` 'UNKNOWN_LOG_TYPE' | 'IMP' | 'CLICK' | 'CONVERSION' | 'SKAN_CONVERSION' | 'ENGAGED_VIEW', required — Type enumerates available log types. Unknown log type. - IMP: Log type which includes every impression log. - CLICK: Log type which includes every click log. - CONVERSION: Log type which includes every conversion event log. - SKAN_CONVERSION: Log type which includes SKAdNetwork attributed conversion event log. - ENGAGED_VIEW: Log type which includes every engaged view log.
  - `format` 'UNKNOWN_LOG_FORMAT' | 'CSV' | 'AVRO' | 'PARQUET' — Format enumerates the format of log. Default is CSV. - CSV: CSV format. - AVRO: Avro format. - PARQUET: Parquet format.
  - `date` string, required — Date for which a log contains the data in "yyyy-mm-dd" format.
  - `ad_account_id` string, required — Ad account ID to which the log is bound.
  - `status` 'UNKNOWN_LOG_STATUS' | 'ACCEPTED' | 'READY' | 'FAILED' — Status enumerates the status of log. - ACCEPTED: Successfully initiated the log generation request. - READY: Successfully generated the log. It's ready to download from the location. - FAILED: Failed to generate the log. Reasons of failure can be found at errors.
  - `skip_compression` boolean — Flag whether to skip compression.
  - `expire_at` string, date-time — The time when a log will be expired.
  - `created_at` string, date-time — Created time.
  - `updated_at` string, date-time — Last updated time. Should not modify on the client side.

## Response `200`

A successful response.

- MessagesCreateLogResponse
  - `log` DspLog — The metadata of a log.
    - `id` string — Unique identifier of the Log. Automatically set by server on creation.
    - `type` 'UNKNOWN_LOG_TYPE' | 'IMP' | 'CLICK' | 'CONVERSION' | 'SKAN_CONVERSION' | 'ENGAGED_VIEW', required — Type enumerates available log types. Unknown log type. - IMP: Log type which includes every impression log. - CLICK: Log type which includes every click log. - CONVERSION: Log type which includes every conversion event log. - SKAN_CONVERSION: Log type which includes SKAdNetwork attributed conversion event log. - ENGAGED_VIEW: Log type which includes every engaged view log.
    - `format` 'UNKNOWN_LOG_FORMAT' | 'CSV' | 'AVRO' | 'PARQUET' — Format enumerates the format of log. Default is CSV. - CSV: CSV format. - AVRO: Avro format. - PARQUET: Parquet format.
    - `date` string, required — Date for which a log contains the data in "yyyy-mm-dd" format.
    - `ad_account_id` string, required — Ad account ID to which the log is bound.
    - `status` 'UNKNOWN_LOG_STATUS' | 'ACCEPTED' | 'READY' | 'FAILED' — Status enumerates the status of log. - ACCEPTED: Successfully initiated the log generation request. - READY: Successfully generated the log. It's ready to download from the location. - FAILED: Failed to generate the log. Reasons of failure can be found at errors.
    - `skip_compression` boolean — Flag whether to skip compression.
    - `expire_at` string, date-time — The time when a log will be expired.
    - `created_at` string, date-time — Created time.
    - `updated_at` string, date-time — Last updated time. Should not modify on the client side.
  - `href` string — Reference URL that shows the log.
  - `status` string — Reference URL that shows the most recent status of the log.

## Other responses

- `202` — Accepted the log creation request.
- `default` — An unexpected error response.

---

[API](https://skmtc.net/moloco/apis/moloco-ads-campaign-management-api.md) · [All operations](https://skmtc.net/moloco/apis/moloco-ads-campaign-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/moloco/moloco-ads-campaign-management-api/revisions/5c85d0910ac0/schema)