The Pinterest Ads integration connects your Pinterest ad account(s) to Medialake. It syncs your campaign hierarchy, ingests the Pins behind your ads as media files, and captures performance metrics — powering Performance dashboards and reports. Everything is read-only: Medialake never creates, edits, pauses, or spends anything in your account.
At a glance
Property | Value |
Category | Advertising |
Auth method | OAuth 2.0 — Pinterest login |
Permissions |
|
API | Pinterest API v5 |
Token renewal | Automatic (Pinterest refresh tokens) |
Metrics capture | Daily buckets, rolled up to weekly, monthly, yearly and lifetime totals |
History window | Up to 90 days — Pinterest's analytics limit |
Before you connect
Spend and every other cost metric are only returned by Pinterest when the connecting account has billing-level access to the ad account. An Analyst permission is enough to sync your campaign structure, creatives, impressions and engagement — but Pinterest silently omits spend, CPC, CPM, CPA and ROAS, and those metrics stay blank in Medialake.
Grant Medialake Campaigns (Campaign Manager) or Admin access on each ad account you want cost reporting for. See Authentication for how to check and set this, and Troubleshooting if spend is already missing.
What it syncs
The full delivery hierarchy — campaigns, ad groups, and ads — plus the Pins behind those ads (images and videos, ingested as files, with carousels split into one file per slide) and performance metrics for each ad, captured in daily buckets.
Pages in this integration
Authentication — the permissions we request, who should connect, and how to revoke access
Data Mapping — the objects we sync and the exact fields we read
Metrics Reference — every metric, its Pinterest analytics column, and how currency conversion works
Troubleshooting — missing spend, missing ads, and other common issues
Questions? Contact [email protected].
