Pinterest Conversions API for Shopify: Complete Setup Guide (2026)

Pinterest is one of the most underutilized advertising platforms for Shopify merchants. While most store owners focus their ad budgets on Meta, Google, and TikTok, Pinterest quietly delivers some of the highest return on ad spend in e-commerce. The platform's users are not just browsing for entertainment. They are actively planning purchases, building wishlists, and searching for products to buy. For merchants selling visual products like fashion, home decor, food, beauty, and DIY supplies, Pinterest traffic converts at rates that rival or exceed other paid channels.

But there is a problem. Just like every other ad platform, Pinterest relies on a browser-based tracking tag to measure conversions. And just like every other browser tag, the Pinterest Tag is increasingly unreliable. Ad blockers, iOS privacy changes, cookie restrictions, and cross-device shopping journeys all cause the Pinterest Tag to miss conversions. If you are running Pinterest ads and only tracking with the browser tag, you are almost certainly undervaluing Pinterest's contribution to your revenue. The Pinterest Conversions API fixes this by sending conversion data directly from your server to Pinterest, bypassing every browser-side limitation.

Why Pinterest Matters for Shopify Merchants

Before diving into tracking setup, it is worth understanding what makes Pinterest different from other advertising platforms and why it deserves a place in your marketing mix.

Unmatched Purchase Intent

Pinterest users behave fundamentally differently from users on other social platforms. On Instagram or TikTok, users scroll through content passively. On Pinterest, users actively search for ideas, products, and solutions. When someone searches for "modern living room furniture" or "summer wedding guest dress" on Pinterest, they are signaling clear purchase intent. Studies consistently show that Pinterest users are significantly more likely to purchase products they discover on the platform compared to users on other social networks. This intent-driven behavior means that Pinterest ad clicks are inherently more valuable because the users are already in a buying mindset.

Visual Product Discovery

Pinterest is a visual search engine. Users browse through images and videos of products, interiors, outfits, recipes, and projects. For Shopify merchants with visually appealing products, Pinterest is a natural fit. Your product images become discoverable through both organic search and paid promotion. Unlike text-based search ads, Pinterest ads blend seamlessly into the user experience. A promoted pin showing your handmade ceramic vase appears right alongside organic pins of similar home decor, reaching users at the exact moment they are looking for products like yours.

Long Content Lifespan

Unlike ads on other social platforms that stop delivering the moment your budget runs out, Pinterest content has an exceptionally long shelf life. Pins can continue driving traffic for months or even years after they are created. When someone saves your promoted pin to their board, it becomes a permanent piece of content that can be rediscovered by other users organically. This means your paid investment on Pinterest compounds over time in ways that Facebook and TikTok ads simply do not.

High-Performing Verticals

Pinterest delivers particularly strong results for specific product categories. If your Shopify store sells products in any of these categories, Pinterest should be a core part of your ad strategy:

Fashion and apparel: Clothing, accessories, jewelry, and shoes perform exceptionally well because users actively search for outfit inspiration and style ideas.
Home decor and furniture: Pinterest is the go-to platform for interior design inspiration. Users searching for room makeover ideas are ready to buy.
Food and beverages: Recipe pins drive enormous traffic, and products like specialty ingredients, kitchen tools, and gourmet food items convert consistently.
Beauty and skincare: Tutorial-style pins and product showcases attract users actively researching their next purchase.
DIY and crafts: Craft supplies, tools, and project kits find a highly engaged audience on Pinterest.
Wedding and events: Pinterest is the dominant platform for wedding planning, making it a goldmine for event-related products.

The Pinterest Tag Problem

The Pinterest Tag is a JavaScript snippet you place on your Shopify store to track visitor actions like page views, add-to-cart events, and purchases. When a user who clicked a Pinterest ad completes a purchase, the tag fires and reports the conversion back to Pinterest. In theory, this gives you accurate data on which ads drive sales. In practice, the Pinterest Tag suffers from the exact same problems as the Meta Pixel, TikTok Pixel, and every other browser-based tracking tag.

Ad Blockers Block the Pinterest Tag

Ad blockers and privacy browser extensions do not discriminate between tracking scripts. They block the Pinterest Tag just as aggressively as they block the Meta Pixel. Between 30 and 40 percent of desktop users have some form of ad blocking or tracking prevention enabled. When these users visit your Shopify store after clicking a Pinterest ad, the tag never loads. Pinterest never learns about the visit, the add to cart, or the purchase. That revenue is real, but it is invisible to Pinterest's ad reporting.

iOS 14+ and Safari Restrictions

Apple's App Tracking Transparency framework, introduced with iOS 14, allows users to opt out of cross-app tracking. The vast majority of iOS users choose to opt out. Safari's Intelligent Tracking Prevention further limits cookie lifetimes to seven days for third-party scripts. Pinterest's user base skews heavily toward iOS and Safari, which means these restrictions have a disproportionate impact on Pinterest ad tracking compared to platforms with more Android-heavy audiences. A user who clicks your Pinterest ad on their iPhone and purchases three days later may not be attributed correctly because the tracking cookie has already been limited.

Cross-Device Shopping Journeys

Pinterest is primarily a mobile-first platform. Users discover products on their phone while browsing Pinterest, but many complete their purchases later on a desktop or laptop. The Pinterest Tag on your Shopify store uses cookies that are specific to a single browser on a single device. When a user switches devices between discovering your product and buying it, the tag cannot connect these sessions. The purchase happens but Pinterest attributes it to nothing, making your Pinterest campaigns look less profitable than they actually are.

Shopify Checkout Domain Changes

Many Shopify stores use a checkout process that transitions the customer to a different domain or subdomain. This domain switch can break cookie continuity, causing the Pinterest Tag to lose track of the user mid-checkout. The most critical conversion event, the purchase itself, is the one most likely to be missed because it happens on the checkout page where domain transitions commonly occur.

What Is the Pinterest Conversions API

The Pinterest Conversions API, often called Pinterest CAPI, is Pinterest's server-side tracking solution. Instead of relying on JavaScript running in the customer's browser, the Conversions API allows you to send conversion events directly from your server to Pinterest's servers. The data travels server-to-server, which means it is completely unaffected by ad blockers, browser privacy settings, cookie restrictions, and device switching.

When a customer completes a purchase on your Shopify store, the event data is sent from your server to Pinterest along with hashed customer identifiers like email address and phone number. Pinterest matches this hashed data against its own user database to attribute the conversion to the correct ad click or impression. Because the matching happens on Pinterest's side using first-party data, the attribution accuracy is significantly higher than what the browser tag can achieve.

How Server-Side Tracking Recovers Lost Data

The Conversions API recovers conversions that the Pinterest Tag misses in several ways. When a user has an ad blocker installed, the server-side event still reaches Pinterest because it never passes through the browser. When a user switches devices, the hashed email or phone number allows Pinterest to match the conversion to the original ad click regardless of which device completed the purchase. When Safari restricts cookie lifetimes, the server-side event bypasses cookies entirely. The result is a more complete and accurate picture of how your Pinterest ads perform.

Pinterest Tag Plus Conversions API

The Conversions API is designed to work alongside the Pinterest Tag, not replace it. You should keep the Pinterest Tag active on your Shopify store while also sending server-side events. Pinterest's system automatically deduplicates events that arrive from both sources, so you will not see double-counted conversions. The combined approach gives Pinterest the most data to work with. The browser tag captures events where it can, and the server-side API fills in the gaps where the tag fails. This dual-tracking approach typically recovers 30 to 60 percent more conversions than using the tag alone.

Pinterest Conversions API vs Pinterest Tag

Factor	Pinterest Tag (Browser)	Conversions API (Server-Side)
Blocked by ad blockers	Yes	No
Affected by iOS 14+	Yes	No
Cross-device attribution	Very limited	Strong (via hashed identifiers)
Cookie dependency	Yes (7-day cap on Safari)	No
Data reliability	50-70% of actual conversions	90-95% of actual conversions
Checkout domain resilience	Breaks on domain switch	Unaffected
Setup complexity	Simple (paste code)	Requires server integration

Which Events to Send to Pinterest

Pinterest's Conversions API supports several standard e-commerce events. For Shopify merchants, these are the key events that drive campaign optimization and accurate reporting:

page_visit: Triggered when a customer views a product page on your store. This event helps Pinterest understand which products attract interest from ad-referred visitors. It feeds Pinterest's algorithm with engagement signals so it can optimize ad delivery toward users who are more likely to interact with similar products.
add_to_cart: Fired when a customer adds a product to their cart. This is a strong purchase intent signal. Pinterest uses add-to-cart data to build lookalike audiences of users who exhibit similar shopping behavior, helping you reach new potential customers who are likely to convert.
checkout: Sent when a customer initiates the checkout process. This event identifies users who are very close to purchasing and helps Pinterest optimize for high-intent actions rather than just page views. It also allows you to create retargeting audiences of users who started checkout but did not complete their order.
purchase: The most critical event. This is the actual conversion that determines your return on ad spend. Without accurate purchase tracking, Pinterest cannot calculate your ROAS, optimize for conversions, or attribute revenue to the correct campaigns. Missing purchase events is the single biggest reason Pinterest ads appear to underperform.

Sending the full funnel of events from page visit through purchase gives Pinterest a complete view of your customer journey. The algorithm uses this data to find more users who exhibit the same progression from casual browsing to completed purchase, continuously improving your campaign efficiency.

Setting Up Pinterest Conversions API Manually

If you want to build the integration yourself, here is what the manual setup process involves. Be aware that this approach requires significant developer time and ongoing maintenance.

Step 1: Create a Pinterest Business Account and App

You need a Pinterest Business account with access to the Pinterest API. Go to the Pinterest Developer Portal and create an app to obtain your API access token. You will also need your Pinterest ad account ID and advertiser ID to configure the Conversions API endpoint.

Step 2: Set Up Server-Side Event Listeners

You need to configure your server to listen for Shopify webhooks. At minimum, you will need to subscribe to orders/create, checkouts/create, and carts/update webhooks. Each webhook payload contains the customer and order data you need to construct the API request to Pinterest.

Step 3: Format and Hash Customer Data

Pinterest requires customer identifiers to be hashed with SHA-256 before sending. You must normalize the data first: lowercase email addresses, remove spaces from phone numbers, and apply consistent formatting. Improperly hashed data will result in low match rates and wasted implementation effort.

Step 4: Send Events to Pinterest's API Endpoint

Construct HTTP POST requests to Pinterest's /ad_accounts/{ad_account_id}/events endpoint with the properly formatted event data. Each request must include the event name, event time, user data with hashed identifiers, and custom data like currency and value for purchase events.

Step 5: Implement Event Deduplication

If you are running the Pinterest Tag alongside the Conversions API, you must send a matching event_id with both the browser and server events. Pinterest uses this ID to deduplicate events and avoid double-counting. This requires coordinating between your front-end tag implementation and your server-side code.

Step 6: Monitor and Maintain

Pinterest updates its API periodically. You need to monitor for deprecation notices, handle API errors and retries, manage rate limits, and keep your integration up to date. If your server goes down, events are lost. You need to build queuing and retry logic to handle failures gracefully.

The manual approach is feasible but requires a developer, a hosting environment, and an ongoing commitment to maintenance. For most Shopify merchants, this level of complexity is not practical.

Setting Up Pinterest Conversions API with Converlay

Converlay eliminates the entire manual process. It is a Shopify app built specifically for server-side event forwarding. Converlay connects to Shopify's backend and automatically sends conversion events to Pinterest's Conversions API along with seven other ad platforms including Meta, Google, TikTok, Snapchat, Reddit, Klaviyo, and Criteo.

Step 1: Install Converlay

Install Converlay from the Shopify App Store . The installation takes less than a minute and does not require any code changes to your theme or checkout.

Step 2: Connect Pinterest

In the Converlay dashboard, navigate to the Pinterest integration and enter your Pinterest ad account credentials. Converlay will verify the connection and confirm that events can be delivered to your Pinterest account.

Step 3: Events Start Flowing

Once connected, Converlay immediately begins capturing events from Shopify's backend and forwarding them to Pinterest. Every page visit, add to cart, checkout initiation, and purchase is sent server-side with properly hashed customer data. There is no lag, no code to maintain, and no server infrastructure to manage.

What Converlay Handles Automatically

Event deduplication: Converlay coordinates with the Pinterest Tag to prevent double-counting. Each event includes a unique event ID that Pinterest uses to deduplicate browser and server events.
Data hashing: Customer email addresses, phone numbers, and other identifiers are automatically normalized and hashed with SHA-256 before being sent to Pinterest.
Retry logic: If an event delivery fails due to a temporary API error, Converlay automatically retries the delivery to ensure no conversion data is lost.
Event enrichment: Converlay enriches each event with product data including product IDs, names, categories, prices, and quantities so Pinterest has full context for optimization.
Multi-platform forwarding: The same conversion events are simultaneously sent to all your connected ad platforms. Setting up Pinterest tracking with Converlay also means your Meta, Google, TikTok, and other integrations are covered with a single installation.

Verifying Your Pinterest Conversions API Data

After setting up server-side tracking, you need to verify that events are arriving correctly in Pinterest. Here is how to confirm everything is working.

Check Pinterest Ads Manager

Log into your Pinterest Ads Manager and navigate to the Conversions section. You should see events arriving from the API source within minutes of setup. Pinterest displays events from the browser tag and the Conversions API separately, so you can see exactly how many additional conversions the server-side integration is capturing.

Monitor Event Match Rate

The event match rate tells you what percentage of server-side events Pinterest can match to a user in its system. A match rate above 30 percent is acceptable. Rates above 50 percent indicate strong data quality. If your match rate is low, it usually means the hashed customer identifiers are not matching Pinterest's user database, which could indicate a formatting issue with the data. Converlay handles the normalization and hashing correctly by default, so low match rates with Converlay are rare.

Compare Before and After

The most meaningful way to measure the impact of the Conversions API is to compare your Pinterest ad metrics from before and after implementation. Track these numbers over a two-week period:

Total attributed conversions: This number should increase by 20 to 50 percent as the Conversions API recovers conversions the tag was missing.
Reported ROAS: With more conversions attributed to your Pinterest campaigns, your reported ROAS should improve significantly without changing your ad spend.
Campaign optimization: Over two to four weeks, Pinterest's algorithm will begin using the additional conversion data to optimize delivery. You should see gradual improvements in cost per conversion as the system learns from the more complete dataset.

Common Mistakes When Setting Up Pinterest CAPI

Removing the Pinterest Tag: The Conversions API is meant to complement the Pinterest Tag, not replace it. Keep both running simultaneously. The tag provides real-time browser signals while the API fills tracking gaps. Pinterest's deduplication system ensures events are not counted twice.
Sending events without customer identifiers: The Conversions API's power comes from matching events to Pinterest users. If you send purchase events without hashed email addresses or phone numbers, Pinterest cannot attribute the conversion to an ad click. Always include at least one hashed identifier with every event.
Ignoring event delivery failures: Server-side events can fail due to API errors, rate limits, or incorrect configuration. If you are not monitoring delivery status, you might think tracking is working when events are actually being dropped. Converlay surfaces delivery status in its dashboard so issues are visible immediately.
Not sending the full event funnel: Some merchants only send purchase events through the Conversions API. While purchase events are the most important, sending the complete funnel including page visits, add to cart, and checkout events gives Pinterest much more data to optimize your campaigns effectively.
Delaying implementation: Every day you run Pinterest ads without server-side tracking is a day of incomplete data. The algorithm is optimizing based on partial information, which means you are likely paying more per conversion than you need to. The sooner you implement the Conversions API, the sooner Pinterest can see your full conversion picture.

Why Pinterest Ads Deserve Better Tracking

Pinterest is often the last platform Shopify merchants add to their advertising mix, but the merchants who do add it frequently report that it delivers their best ROAS. The combination of high purchase intent, visual product discovery, and long content lifespan makes Pinterest uniquely effective for e-commerce. However, none of that matters if your tracking is broken.

When the Pinterest Tag misses half your conversions, your Pinterest campaigns look unprofitable. You reduce budget or pause campaigns entirely, missing out on revenue from a channel that was actually performing well. Accurate server-side tracking reveals the true value of your Pinterest investment and gives you the confidence to scale what is working.

The Pinterest Conversions API is not just a technical improvement. It is the difference between seeing Pinterest as a money pit and recognizing it as a profitable growth channel for your Shopify store.

Start Tracking Pinterest Conversions Accurately

If you are running Pinterest ads for your Shopify store, or if you have been hesitant to try Pinterest because previous campaigns showed poor results, server-side tracking changes everything. The Conversions API ensures Pinterest sees every conversion, your ROAS reflects reality, and the algorithm has the data it needs to find your best customers.

Ready to unlock the full potential of your Pinterest ads? Install Converlay on your Shopify store and start sending server-side events to Pinterest in minutes. No code, no developer needed, and you will see the difference in your Pinterest Ads Manager within days.