---
title: "Receive notifications from external partners."
method: POST
path: "/notifications"
tags: ["notification"]
---

# Receive notifications from external partners.

`POST /notifications`

Used by third-party partners to send notifications to Pinterest. These notifications could be specific for your use-case or generic notification that are accepted by Pinterests' systems. This API is gated and you need to request access to this feature.

## Request body

- union — Notification request body. Can be either a batch of notification objects or a single notification object.
  - object[] — Batch of 1-100 notification objects.
  - NotificationSingleRequest — A single notification object.

## Response `200`

The request has succeeded.

- NotificationResponse
  - `error_msg` string — error message when success is false
  - `received_at` integer — Received time. Unix timestamp in seconds.
  - `success` boolean — Returns true if the notification accepted.

## Other responses

- `400` — The request could not be understood by the server due to unexpected data.
- `default` — An unexpected error response.

## Changes

- **2026-06-04** (v5) `b698c180678a` — 1 breaking, 1 info
  - removed `subschema #1` from the request body `oneOf` list
  - added `#/components/schemas/NotificationBatchRequest` to the request body `oneOf` list
- **2025-10-16** (v5) `14c297539b64` — 1 info
  - the endpoint scheme security `client_credentials` was added to the API
- **2025-07-16** (v5) `43134ca41f18` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/pinterest/apis/pinterest-rest-api/changes/notifications/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/b698c180678a/schema)