---
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 — Any valid JSON object
  - object[]
  - object

## Response `200`

Successfully received notification

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

## Other responses

- `400` — Invalid request parameter.
- `default` — Unexpected error

## Changes

- **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/7d64d863909a/schema)