Setting Up UniPixel With: Pinterest

To connect Pinterest, you need three things from your Pinterest Ads account: a Tag ID, an Ad Account ID, and a Conversions API Access Token. This page walks through getting each one.


The Shopping List

You need four things, in this order:

  1. A Pinterest Business Account
  2. A Pinterest Ad Account (the Ad Account ID is needed for API calls)
  3. A Pinterest Tag (created inside Ads Manager)
  4. A Conversions API Access Token

If you already run Pinterest ads, you probably have the first three. The access token is the one most people need to generate.


Already Have Some of These?

If you’re already running Pinterest ads and have a tag set up:

  • Tag ID — go to Pinterest Ads Manager (ads.pinterest.com). From the top menu, select Ads > Conversions. In the left menu, click Tag manager. Your Tag ID is the numeric string shown next to your tag name, or click the three dots next to your tag and select Configure Base Code to see it.
  • Ad Account ID — from the top-left of Ads Manager, click your business name or the hamburger menu. Under Manage business, click Business manager, then Assets > Ad accounts. Your Ad Account ID is the 13-digit number shown under your ad account name.
  • Access Token — from Ads Manager, click the hamburger menu at the top-left. Under Manage business, click Conversions. Select Set Up API from the left navigation. If you’ve already generated a token, it will be shown here. If not, you’ll generate one in the steps below.

If all three are in hand, skip ahead to What to Enter in UniPixel.


If You’re Starting From Scratch

Step 1: Create a Pinterest Business Account

Go to Pinterest for Business (business.pinterest.com) and sign up. If you already have a personal Pinterest account, you can convert it to a business account from your account settings.

Step 2: Set Up a Pinterest Ad Account

Once your business account exists, go to Pinterest Ads Manager (ads.pinterest.com). Complete the initial setup: business information, billing country, and time zone. You don’t need to create a campaign or add payment yet — but you do need an ad account to exist, because the Ad Account ID is required for the Conversions API.

Your Ad Account ID is the 13-digit number shown in Ads Manager under your business name, or under Business manager > Assets > Ad accounts.

Step 3: Create a Pinterest Tag

In Ads Manager:

  1. From the top menu, select Ads > Conversions.
  2. In the left menu, click Tag manager.
  3. Click Create Tag (or Install the Pinterest Tag if this is your first).
  4. Give it a name — for example, your website name.
  5. For the installation method, you can skip any code installation steps. UniPixel handles this for you.
  6. Click Done or Save.

Your Tag ID is now visible on the Tag manager page — the numeric string next to your tag name. You can also click the three dots next to your tag and select Configure Base Code to see it.

Step 4: Generate a Conversions API Access Token

Still in Ads Manager:

  1. Click the hamburger menu (top-left of the page).
  2. Under Manage business, click Conversions.
  3. Select Set Up API from the left navigation.
  4. Click Generate new token.
  5. Copy it immediately. Pinterest only shows the full token once. Store it somewhere safe before pasting it into UniPixel.

If you generate a new token later, the old one stops working and you’ll need to update it in UniPixel.


What to Enter in UniPixel

Go to your WordPress admin > UniPixel > Pinterest > Tag Setup:

  • Turn On / Enabled — switch this on.
  • Pixel Setting — select “Include Pinterest’s Tracking Tag for me” (unless you’ve already added the Pinterest tag to your site through another method).
  • Tag ID — paste your numeric Tag ID from Step 3.
  • Ad Account ID — paste the 13-digit Ad Account ID from Step 2.
  • Access Token — paste the token you generated in Step 4.

Click Update Settings. Pinterest tracking is now live.


What to Ignore

Pinterest’s setup flow will try to get you to:

  • Install tag code manually — you don’t need to. UniPixel adds the Pinterest tag script automatically when you select “Include Pinterest’s Tracking Tag for me.”
  • Use a partner integration — skip this. UniPixel is your integration.
  • Set up events inside Pinterest’s Events Manager — skip this too. Events are configured inside UniPixel. WooCommerce events (Purchase, AddToCart, etc.) are tracked automatically. Custom events are set up in UniPixel’s Pinterest Events page.
  • Use Pinterest’s own WooCommerce extension — you don’t need it. UniPixel replaces this entirely.

Do I Need to Install the Pinterest Tag Code on My Site?

No. When you select “Include Pinterest’s Tracking Tag for me” in UniPixel, the tag script is added to your site automatically. You don’t need to paste any code into your theme, header, or a tag manager.

If you’ve already added the Pinterest tag through another plugin or manually in your theme, select “Pinterest’s Tracking Tag is already on my site” instead. UniPixel will send events through the existing tag and handle server-side tracking alongside it.


Does This Handle Both Client-Side and Server-Side?

Yes. UniPixel sends Pinterest events both ways:

  • Client-side — through Pinterest’s tag script running in the visitor’s browser (pintrk).
  • Server-side — directly from your WordPress server to Pinterest’s Conversions API.

Both are sent with the same event ID, so Pinterest deduplicates them automatically. They count as one conversion, not two. This is configured per event in UniPixel’s Pinterest Events page.


Common Questions

Do I need Pinterest’s own WooCommerce extension? No. UniPixel tracks WooCommerce events (Purchase, AddToCart, InitiateCheckout, ViewContent) automatically. Pinterest’s WooCommerce extension would duplicate this.

What if I already have the Pinterest tag on my site from another plugin? Select “Pinterest’s Tracking Tag is already on my site” in UniPixel. This prevents loading the tag script twice while still allowing UniPixel to send server-side events and custom events.

Why does UniPixel need an Ad Account ID? The other platforms don’t ask for one. Pinterest’s Conversions API requires the Ad Account ID as part of the API endpoint URL. Meta, TikTok, and Google don’t need this because their API endpoints use the pixel/tag ID instead. It’s just how Pinterest designed their API.

What events does UniPixel send to Pinterest? With WooCommerce: checkout (purchase completion), add_to_cart, initiate_checkout, and view_content — all automatic. Plus page_visit (PageView) if you enable it, and any custom events you configure.

How do I know it’s working? After setup, use UniPixel’s event log to see events fire. You can also check Pinterest Ads Manager > Conversions > Event history to verify events are being received. Allow up to 24 hours for Pinterest to start showing incoming events in their dashboard.

Pinterest uses different event names — is that handled? Yes. Pinterest calls a completed purchase “checkout” (not “Purchase” like Meta). UniPixel handles all the name mapping automatically. The events page shows the actual names sent to Pinterest so you can see exactly what’s being delivered.


Sources used for Pinterest setup steps: