---
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

- IntegrationLogsRequestCreate — Resource create operation model.
  - `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 for integration applications.
    - `external_business_id` string, nullable
    - `feed_profile_id` string, nullable
    - `log_level` 'INFO' | 'WARN' | 'ERROR', required — Log level type for integration applications.
    - `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 — HTTP request method.
      - `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`

The request has succeeded.

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

## Other responses

- `400` — The server could not understand the request due to invalid syntax.
- `401` — Authentication is required and has either failed or not been provided.
- `403` — The request was valid, but the server is refusing action. The user might not have the necessary permissions for a resource.
- `404` — The requested resource could not be found on this server.
- `429` — The user has sent too many requests in a given amount of time and is being rate limited.
- `default` — An unexpected error response.

---

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