Key Takeaways
- Single-column CSV only. Emails or mobile ad IDs, never both, and no names, phones or addresses.
- Hash emails as typed: trim, lowercase, SHA-256. MD5 and cleartext are also accepted. Keep Gmail dots.
- Cleartext emails must contain an @.
- Minimum to serve: 100 matched users.
- New audiences take 48–72 hours to process.
- Lists can’t be downloaded back once uploaded; keep your own source file.
Pinterest customer list audiences let you show ads to people you already know while they plan purchases, projects and events. For retail, home, food, travel and wedding brands, it’s one of the most intent-rich places to reach your existing customers.
Pinterest also has the strictest file format of any major ad platform: one column, one identifier type, nothing else. The multi-column export that works on Meta or Google will fail on Pinterest.
This guide covers Pinterest’s customer list rules for 2026: file format, email hashing, mobile ad IDs, the API and audience sizes. For all nine major platforms side by side, see our ultimate guide to hashed emails.
Pinterest Audience Targeting Options: Where Customer Lists Fit
Pinterest offers several ways to target people you know:
| Audience type | Built from | Hashed data? |
|---|---|---|
| Customer list | Emails or mobile ad IDs you upload | Yes, or cleartext |
| Visitor | Pinterest Tag activity on your site | No |
| Engagement | People who engaged with your Pins | No |
| Act-alike | People who behave like a seed audience | No |
This guide covers customer lists. They’re used to:
- Retarget past buyers with seasonal or replenishment Pins.
- Exclude existing customers from acquisition campaigns.
- Seed act-alike audiences (Pinterest’s lookalikes) from your best customers.
- Reach customers early in planning, before they search elsewhere.
Pinterest Customer List Requirements
| Requirement | |
|---|---|
| Hash | SHA-256, MD5, or cleartext |
| Email normalization | Trim, lowercase; keep Gmail dots |
| File format | Single-column CSV |
| Identifier types | Emails or mobile ad IDs, never both in one list |
| Extra fields | None: no names, phones or addresses |
| Minimum to serve | 100 matched users |
| Processing time | Usually 48–72 hours for a new audience |
| Hashes for you? | Yes, uploads are hashed on arrival |
| API | customer_lists endpoints in API v5 |
Pinterest’s 100-user floor matches Google, Meta and X, and is far below Reddit and TikTok at 1,000.
Source: Pinterest Help: Customer list audiences
The Single-Column Rule
A Pinterest customer list file has one column. That’s it.
f1904cf1a9d73a55fa5de0ac823c4403ded71afd4c3248d00bdcd0866552bb79
375320dd9ae7ed408002f3768e16cb5f28c861062fd50dff9a3bff62e9dce4ef
0925f997eb0d742678f66d2da134d15d842d57722af5f7605c4785cb5358831bWhat this means in practice:
- A CRM export will fail. Export a dedicated email-only file before you upload.
- Leave out names, phones and addresses. Pinterest’s help docs say to exclude them.
- Emails and mobile IDs go in separate lists. Never mix them in one file.
- Each of a person’s emails goes on its own line. If you have a work email and two personal emails, list all three. Pinterest only counts matched users, so extra lines don’t inflate your audience.
X and Snapchat also keep one identifier type per upload, but Pinterest is the only one that forbids extra columns entirely. Our hashed email specs comparison shows each platform’s file shape side by side.
How to Hash Emails for Pinterest
- Trim whitespace.
- Lowercase the address.
- Hash with SHA-256.
- Encode as lowercase hex.
Pinterest also accepts MD5 and cleartext, but SHA-256 is the better choice: every other major platform uses it, so one pipeline covers Pinterest and the rest.
Keep Gmail dots and +tags. Removing dots is a Google-only rule; if one pipeline feeds both, keep two hashes per email and send Pinterest the raw one.
Test vector:
mary@example.com
f1904cf1a9d73a55fa5de0ac823c4403ded71afd4c3248d00bdcd0866552bb79Cleartext uploads need an @
If you upload plain-text emails, each one must contain an @. Pinterest uses it as a sanity check, so values without one are dropped. Pinterest hashes cleartext lists immediately on arrival.
Don’t mix formats
Keep one format per file: all SHA-256, all MD5 or all cleartext. Mixed files are harder to debug and risk values being hashed twice.
Mobile Ad IDs on Pinterest
Mobile ad IDs get their own customer list:
- Android advertising IDs only. Pinterest’s policy doesn’t allow iOS IDFAs.
- Lowercase, in the standard 8-4-4-4-12 format (for example,
38400000-8cf0-11bd-b23e-10b96e40000d). - Drop all-zero IDs.
00000000-0000-0000-0000-000000000000means the user opted out of tracking.
Compare that with Reddit, which reads MAID casing as device type, and Snapchat, which hashes MAIDs.
Uploading a Customer List
Ads Manager
- Open Ads, then Audiences.
- Click Create audience and choose Customer list.
- Upload your single-column CSV and name the audience.
Pinterest API v5 (customer_lists)
Pinterest’s API v5 customer_lists endpoints let you create a list and then add, remove or replace its members. That’s the better route for CRM syncs, because you can update a list in place instead of creating new audiences.
You can’t download a list back
Pinterest hashes lists as soon as they arrive. You can add, remove or replace members, but you can’t export the list from Pinterest. Keep your own copy of every file you upload, so you know exactly who’s in each audience.
Improving Your Pinterest Match Rate
Check the format first:
- One column, one identifier type.
- No header row confusion: if your tool adds a header, make sure it isn’t being read as an email.
- Remove blank values before hashing. An empty string hashes to
e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855. - Keep Gmail dots.
Then improve the list:
- Add personal emails. People join Pinterest with personal addresses. Work emails rarely match. A people data API can find them from a work email or LinkedIn URL.
- Include every known email per person, each on its own line.
- Upload a separate Android MAID list if you have app users.
- Use the right list for the job. Pinterest has no phone or address matching, so the email is the only route to most people.
A Tested Python Snippet for Pinterest
import hashlib
def pinterest_email_hash(email: str) -> str | None:
e = email.strip().lower() # keep Gmail dots
return hashlib.sha256(e.encode("utf-8")).hexdigest() if "@" in e else None
def pinterest_email_file(emails: list[str]) -> str:
"""Single-column file: one hashed email per line, no header, no other fields."""
hashes = {h for h in map(pinterest_email_hash, emails) if h}
return "\n".join(sorted(hashes)) + "\n"
def pinterest_maid_file(android_ids: list[str]) -> str:
"""Separate list for Android ad IDs: lowercase, opt-outs dropped."""
ids = {i.strip().lower() for i in android_ids}
ids.discard("00000000-0000-0000-0000-000000000000")
ids.discard("")
return "\n".join(sorted(ids)) + "\n"
assert pinterest_email_hash(" Mary@Example.com ") == (
"f1904cf1a9d73a55fa5de0ac823c4403ded71afd4c3248d00bdcd0866552bb79"
)
assert pinterest_email_file(["a@b.com", " A@B.com "]).count("\n") == 1Pinterest Customer List FAQ
Can I upload names or phone numbers to Pinterest?
No. Pinterest customer lists take a single column of emails or mobile ad IDs only.
What’s the minimum size for a Pinterest customer list audience?
100 matched users.
Does Pinterest hash my list for me?
Yes. Cleartext uploads are hashed on arrival. You can also upload SHA-256 or MD5 hashes.
Can I target iPhone users with mobile IDs?
Not with IDFAs, which Pinterest’s policy doesn’t allow. Use email lists to reach iOS users.
How long does a Pinterest audience take to be ready?
Usually 48–72 hours for a new audience.
Can I download a customer list from Pinterest?
No. Keep your own source file. You can still add, remove and replace members.
Get Pinterest-Ready Hashes with Limadata
With only one column to work with, the email you send is everything on Pinterest. If it isn’t the address someone signed up with, there’s no fallback.
Limadata’s Ad Audience API takes a LinkedIn URL or work email and returns every personal email we can resolve for each person, already hashed. Put them all in your single-column file and give every contact several chances to match.
Sign up free and test it on your own list, or see pricing.
Related reading:
- The Ultimate Guide to Hashed Emails (All Platforms) in 2026
- Facebook Custom Audiences from a Customer List
- Google Customer Match in 2026: How to Hash and Upload Emails
- LinkedIn Matched Audiences: How to Hash and Upload Contact Lists
- X (Twitter) Custom Audiences and Ads API Guide
- Reddit Custom Audiences and the Reddit Ads API
- TikTok Custom Audience from a Customer File
- Snap Audience Match and the Snapchat Marketing API
- Amazon Custom Audience Advertising: Hashed Lists for DSP and AMC
