BetaNew: Candidate Fraud Detection API.Join the waitlist

Reddit Custom Audiences & Reddit Ads API: Customer List Guide

•Limadata team•2 min read
Reddit Custom Audiences template headers with a SHA-256 hashed email test vector and the 1,000-user minimum

Key Takeaways

  • Hash emails as typed: trim, lowercase, SHA-256, hex. Keep Gmail dots and +tags.
  • Use Reddit’s template headers unchanged: Emails (hashed), Emails (unhashed), Mobile Ad IDs (unhashed).
  • CSV files up to 500 MB.
  • Minimum to serve: 1,000 matched users.
  • The API accepts hashed values only (EMAIL_SHA256, MAID_SHA256).
  • Send additions before removals on syncs so the audience never drops below 1,000.

Reddit has become a serious channel for B2B and technical audiences: developers, IT buyers, finance people and practitioners in almost every niche. Reddit Custom Audiences let you upload your customer list and reach those people while they browse the communities they care about.

The hashing is standard. What makes Reddit different is its strict upload template (rename a header and the upload fails) and its 1,000-matched-user minimum, tied with TikTok for the highest bar of any major self-serve ad platform.

This guide covers Reddit’s customer list rules in 2026: hashing, the template, the API, mobile ad IDs and how to keep audiences above the floor. For all nine major platforms side by side, see our ultimate guide to hashed emails.

Reddit Ads Targeting with Custom Audiences

Reddit Custom Audiences group people you already know. Reddit supports several sources:

TypeBuilt fromHashed data?
Customer listEmails and mobile ad IDs you uploadYes, or unhashed in Ads Manager
Website retargetingReddit Pixel or Conversions API eventsNo
EngagementPeople who interacted with your adsNo
LookalikePeople similar to a seed audienceNo

This guide covers customer lists. Advertisers use them to:

  • Retarget customers and trial users in relevant communities.
  • Exclude existing customers from acquisition spend.
  • Seed lookalikes from your best accounts.
  • Reach technical buyers who ignore LinkedIn ads but read Reddit daily. B2B audience tools such as Primer sync lists to Reddit too; see our Primer alternatives comparison.

Reddit Customer List Requirements

RequirementReddit customer list
HashSHA-256, hex
Email normalizationTrim, lowercase; keep Gmail dots
File formatCSV up to 500 MB, Reddit’s template headers unchanged
Accepted identifiersEmails and mobile ad IDs
Minimum to serve1,000 matched users
Hashes for you?Ads Manager accepts unhashed emails; the API takes hashed only

The 1,000-user minimum

A Reddit customer list needs 1,000 matched users before it can run. That’s ten times Google’s and X’s floor. Plan for that:

  • Upload many thousands of rows if your list is mostly work emails.
  • Combine related segments into one audience if each is small.
  • Add personal emails and mobile ad IDs for the same people to lift matches.

Source: Reddit Business Help: Custom Audiences

How to Hash Emails for Reddit

  1. Trim whitespace.
  2. Lowercase the address.
  3. Hash with SHA-256.
  4. Encode as lowercase hex.

That’s all. Reddit’s own template example hashes user@email.com with no further changes, and nothing in Reddit’s documentation asks you to strip dots or aliases.

Test vector from Reddit’s template

user@email.com
0925f997eb0d742678f66d2da134d15d842d57722af5f7605c4785cb5358831b

We verified this: it’s the plain trimmed, lowercased SHA-256 hash. If your pipeline produces it, you’re formatting correctly for Reddit.

Don’t strip Gmail dots or +tags

Removing Gmail dots is a Google-only rule. Applying it to Reddit breaks the hash for every dotted Gmail address on your list. The same goes for stripping +tags. If one pipeline feeds both, keep two hashes per email.

If you want to be certain, upload the same list both ways as two audiences and compare matched counts. In practice, the as-typed version is what Reddit documents.

Using Reddit’s Template

Reddit provides a CSV template. Use its headers exactly as they are:

HeaderContains
Emails (hashed)SHA-256 hashed emails
Emails (unhashed)Plain-text emails (Reddit hashes them)
Mobile Ad IDs (unhashed)Plain-text mobile advertising IDs

Changed or deleted headers cause upload errors. That includes fixing what look like typos, removing the parentheses, or translating the headers.

A file of pre-hashed emails looks like this:

Emails (hashed)
0925f997eb0d742678f66d2da134d15d842d57722af5f7605c4785cb5358831b
f1904cf1a9d73a55fa5de0ac823c4403ded71afd4c3248d00bdcd0866552bb79

Don’t put hashed values under Emails (unhashed) or the reverse. Reddit will hash them again (or treat raw addresses as hashes), and nothing will match. TikTok has the same trap with its plain and hashed columns.

Multiple emails per person

Reddit’s template has one email column per type, so put each of a person’s emails on its own row. Matched users are de-duplicated, so extra rows don’t inflate your audience; they just give each person more chances to match. That’s the same approach LinkedIn uses.

Mobile ad IDs: casing matters

Reddit reads the case of an unhashed MAID as a signal of device type:

  • Android advertising IDs: lowercase.
  • iOS IDFAs: uppercase.

Drop all-zero IDs (00000000-0000-0000-0000-000000000000). They mean the user opted out of tracking and can’t match. Other platforms want MAIDs in different shapes; Snapchat hashes them and Pinterest takes Android IDs only.

No phones or names

Reddit’s customer list template doesn’t include phone numbers, names or locations. Emails and MAIDs are the only keys, which makes having the right email for each person especially important.

Reddit Ads API: Uploading Customer Lists

The Reddit Ads API (v3) covers campaigns, ad groups, reporting, conversions and audiences. For customer-list syncs, use the Custom Audiences users endpoint:

PATCH /api/v3/custom_audiences/{audience_id}/users

with action_type set to ADD or REMOVE. The API takes hashed values only, using the identifier types EMAIL_SHA256 and MAID_SHA256.

A simplified request body:

{
  "data": {
    "action_type": "ADD",
    "column_order": ["EMAIL_SHA256"],
    "user_data": [
      ["0925f997eb0d742678f66d2da134d15d842d57722af5f7605c4785cb5358831b"],
      ["f1904cf1a9d73a55fa5de0ac823c4403ded71afd4c3248d00bdcd0866552bb79"]
    ]
  }
}

Check the current request schema in Reddit’s API docs before building, as field names can change between versions.

Add before you remove

When you sync a changing list, send additions first, then removals. If you remove first, the audience can briefly drop below 1,000 matched users and stop serving. The customer list API has no membership duration parameter, so removals are the only way people leave the list. TikTok’s Segment API has a similar floor, where updates that would leave an audience under 1,000 fail outright.

Improving Your Reddit Match Rate

Fix the format:

  • Use Reddit’s headers unchanged.
  • Keep Gmail dots and +tags.
  • Remove blank values before hashing. An empty string hashes to e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855.
  • Get MAID casing right (Android lowercase, iOS uppercase).

See common hashed email mistakes for the full checklist.

Then improve the list:

  • Add personal emails. Redditors almost never sign up with a work address. A people data API can find personal emails from a work email or LinkedIn URL.
  • Add MAIDs where you have them from your app.
  • Upload big. At a 1,000-user floor, small lists rarely make it.

A Tested Python Snippet for Reddit

import csv
import hashlib
import io

def reddit_email_hash(email: str) -> str | None:
    e = email.strip().lower()                          # keep dots and +tags
    return hashlib.sha256(e.encode("utf-8")).hexdigest() if "@" in e else None

def reddit_hashed_email_csv(emails: list[str]) -> str:
    """Reddit template file with one hashed email per row."""
    out = io.StringIO()
    writer = csv.writer(out)
    writer.writerow(["Emails (hashed)"])               # exact template header
    for h in sorted({h for h in map(reddit_email_hash, emails) if h}):
        writer.writerow([h])
    return out.getvalue()

assert reddit_email_hash("  User@Email.com ") == (
    "0925f997eb0d742678f66d2da134d15d842d57722af5f7605c4785cb5358831b"
)
assert reddit_email_hash("mary@example.com") == (
    "f1904cf1a9d73a55fa5de0ac823c4403ded71afd4c3248d00bdcd0866552bb79"
)

Reddit Custom Audiences FAQ

What’s the minimum size for a Reddit Custom Audience?

1,000 matched users.

Can I upload unhashed emails to Reddit?

Yes in Ads Manager, under the Emails (unhashed) header. The API only accepts hashed values.

Can I upload phone numbers to Reddit?

Not in the customer list template. Use emails and mobile ad IDs.

Why did my Reddit upload fail?

Most often because a template header was renamed or deleted. Use Reddit’s headers exactly as provided.

Should I strip Gmail dots for Reddit?

No. Only Google asks for that. Reddit’s own example hashes the address as typed.

How do I keep my audience from dropping below 1,000?

Send additions before removals during syncs, and keep a buffer well above the minimum.

Get Reddit-Ready Hashes with Limadata

Reddit is where technical buyers spend time off the clock, signed in with personal emails. A work-email CRM list rarely clears the 1,000-user floor on its own.

Limadata’s Ad Audience API takes a LinkedIn URL or work email and returns the personal emails we can resolve for each person, already hashed for Reddit’s template. More real addresses per person is the fastest way past Reddit’s minimum.

Sign up free and test it on your own list, or see pricing.

Related reading: