---
title: "Receives batched logs from integration applications."
method: POST
path: "/integrations/logs"
tags: ["integrations"]
---

# Receives batched logs from integration applications.

`POST /integrations/logs`

This endpoint receives batched logs from integration applications on partner platforms.
Note: If you're interested in joining the beta, please reach out to your Pinterest account manager.

## Request body

- IntegrationLogsRequest — Batch of logs sent from an integration application.
  - `logs` IntegrationLog[], required
    - `advertiser_id` string, nullable
    - `app_version_number` string — Version number of the integration application.
    - `client_timestamp` integer, required — Timestamp in milliseconds of when the log was executed at the client.
    - `error` IntegrationLogClientError — System error details included in the log sent by the client.
      - `cause` string — Original cause of the error.
      - `column_number` integer — Column number in the line of the file that raised the error.
      - `file_name` string — Filename where the error happened.
      - `line_number` integer — Line number where the error happened.
      - `message` string — Human-readable description of the error.
      - `message_detail` string — More detail about the message.
      - `name` string — Filename where the error happened.
      - `number` integer — Integer that specifies the error code.
      - `stack_trace` string — Stack trace of where the error happened.
    - `event_type` 'APP' | 'API', required — Log event type
    - `external_business_id` string, nullable
    - `feed_profile_id` string, nullable
    - `log_level` 'INFO' | 'WARN' | 'ERROR', required — Log level type
    - `merchant_id` string, nullable
    - `message` string — Explanation of the event that occured.
    - `platform_version_number` string — Version number of the platform the integration application is running on.
    - `request` IntegrationLogClientRequest — HTTP request details included in the log sent by the client.
      - `host` string, required — HTTP request host from host header.
      - `method` 'GET' | 'HEAD' | 'POST' | 'PUT' | 'DELETE' | 'CONNECT' | 'OPTIONS' | 'TRACE' | 'PATCH', required
      - `path` string, required — HTTP request path.
      - `request_headers` object — HTTP request headers as key-value pairs.
      - `response_headers` object — HTTP response headers as key-value pairs.
      - `response_status_code` integer
    - `tag_id` string, nullable

## Response `200`

Success.

- IntegrationLogsSuccessResponse — Response when logs are successfully processed.
  - `message` string

## Other responses

- `400` — Bad request.
- `default` — Unexpected error

## Changes

- **2025-04-04** (v5) `10f9eba4ad97` — 4 breaking, 3 info
  - the response's body type changed from `object` to no type for status `400`
  - removed the required property `code` from the response with the `400` status
  - removed the required property `details` from the response with the `400` status
  - removed the required property `message` from the response with the `400` status
  - …3 more
- **2024-08-14** (v5) `89c27ed39cfd` — 1 breaking
  - the `logs` request property's minItems was increased to `1`
- **2024-02-08** (v5) `7529b464d5cb` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/pinterest/apis/pinterest-rest-api/changes/integrations/logs/post.md)

---

[API](https://skmtc.dev/pinterest/apis/pinterest-rest-api.md) · [All operations](https://skmtc.dev/pinterest/apis/pinterest-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/pinterest/pinterest-rest-api/revisions/6768e3ca1ffa/schema)