ad_accounts14

ad_groups13

ads10

advanced_auction2

audience_insights2

audience_sharing7

audiences4

billing11

boards11

bulk3

business_access_assets12

business_access_invite6

business_access_relationships9

campaigns8

catalog_feeds8

catalog_items3

catalog_product_groups10

catalog_reports3

catalog_supplemental7

catalogs3

conversion_deletion_requests4

conversion_eqs1

conversion_events1

conversion_tags5

conversions4

customer_list_uploads3

customer_lists4

customer_segment3

integrations7

keywords5

labels5

lead_ads4

lead_forms5

leads_export2

media3

msot_events1

notification1

postReceive notifications from external partners.

oauth3

order_lines2

pins8

product_group_promotions5

product_tags3

promotions5

resources6

schedules3

search3

targeting_template3

terms2

terms_of_service1

trends4

user_account14

notification

Receive notifications from external partners.

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.

post/notifications

Request body

object[] required

Batch of 1-100 notification objects.

NotificationSingleRequest required

A single notification object.

Response

The request has succeeded.

error_msgstring

error message when success is false

received_atinteger

Received time. Unix timestamp in seconds.

successboolean

Returns true if the notification accepted.

Changes

Changed in 3 of the 29 revisions of this API.13

Jun 4, 2026v5b698c180678a11See the full diff
- ▲
  removed subschema #1 from the request body oneOf list
  request-body-one-of-removed
- ○
  added NotificationBatchRequest to the request body oneOf list
  request-body-one-of-added
This revision also has 182 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Oct 16, 2025v514c297539b641See the full diff
- ○
  the endpoint scheme security client_credentials was added to the API
  api-security-added
This revision also has 7 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jul 16, 2025v543134ca41f181See the full diff
- ○
  endpoint added
  endpoint-added
This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history