Skip to content

pinterest-ads

Use when creating, managing, or reporting on Pinterest ad campaigns. Also use when setting up Pinterest Conversions API (CAPI), managing audiences, monitoring click attribution via the _epik cookie, or diagnosing Pinterest Ads API issues.

ModelSource
sonnetpack: ads
Full Reference

┏━ πŸ”§ pinterest-ads ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓ ┃ Use when creating, managing, or reporting on P… ┃ ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛

Pinterest Ads API v5 β€” campaign stack (Campaign β†’ Ad Group β†’ Ad). Currency in micro-currency ($1 = 1,000,000). Access tokens expire every 60 days.

ItemValue
API versionv5
Base URLhttps://api.pinterest.com
Currency unitMicro-currency ($5/day = 5000000)
Token lifetime60 days β€” must refresh
Click attribution cookie_epik
I want to…File
Create campaigns, ad groups, and ads β€” full step-by-step, token refreshreference/campaign-setup.md
Send CAPI events, capture _epik cookie, manage audiencesreference/capi-and-attribution.md
Query analytics, check benchmarks, spec creative formatsreference/performance-and-creative.md

Usage: Read the reference file matching your current task from the index above. Each file is self-contained with code examples and inline gotchas.