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

---

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