BetaNew: Candidate Fraud Detection API.Join the waitlist

Snap Audience Match & Snapchat Marketing API Guide (2026)

•Limadata team•3 min read
Snap Audience Match uploads with one schema per request: hashed email, digits-only phone and hashed mobile ad ID

Key Takeaways

  • Hash emails as typed: trim, lowercase, SHA-256, lowercase hex. Keep Gmail dots.
  • One identifier type per upload: emails, phones and MAIDs go in separate batches, even for the same person.
  • Phones are digits only with country code, no +, leading zero dropped (like Meta).
  • MAIDs are hashed: lowercase, hyphens kept, then SHA-256.
  • Up to 100,000 identifiers per API request.
  • No published minimum. Check the segment’s targetable_status for TOO_FEW_USERS.

Snap Audience Match (SAM) lets you upload a customer list and reach those people on Snapchat. For brands targeting under-35 audiences, it’s one of the few ways to reach existing customers on a platform where they spend hours a day.

Snapchat’s hashing rules are standard, with two twists. Every upload carries exactly one identifier type, and mobile ad IDs are hashed too, unlike on Meta and Google. Phones also follow the digits-only format, not E.164.

This guide covers how Snap Audience Match works in 2026: hashing for emails, phones and MAIDs, the Marketing API, retention and how to tell if your audience is big enough. For all nine major platforms side by side, see our ultimate guide to hashed emails.

What Is Snap Audience Match?

Snap Audience Match is Snapchat’s customer-list audience. It sits alongside Snapchat’s other audience types:

Audience typeBuilt fromHashed data?
Snap Audience MatchEmails, phones or mobile ad IDs you uploadYes
Pixel Custom AudienceSnap Pixel activity on your siteNo
EngagementPeople who engaged with your ads or profileNo
LookalikePeople similar to a seed audienceNo

Advertisers use Snap Audience Match to:

  • Retarget customers with launches, drops and offers.
  • Exclude existing customers from acquisition campaigns.
  • Seed lookalikes from high-value customers.
  • Reach younger buyers who are hard to find on other networks.

Snap Audience Match Requirements

RequirementSnapchat
HashSHA-256, lowercase hex (required via API)
Email normalizationTrim, lowercase
API schemasEMAIL_SHA256, PHONE_SHA256, MOBILE_AD_ID_SHA256
Mixing identifiersNot allowed: one schema type per request
API batch sizeUp to 100,000 identifiers per request
RetentionSet per segment; default is lifetime (9999)
Minimum to serveNot published; check targetable_status

Source: Snap Marketing API: Customer Lists

How to Hash Emails for Snapchat

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

Keep Gmail dots and +tags. Removing dots is a Google-only rule; if one pipeline feeds both, keep two hashes per email.

Test vector:

mary@example.com
f1904cf1a9d73a55fa5de0ac823c4403ded71afd4c3248d00bdcd0866552bb79

One Identifier Type per Upload

Snapchat’s defining rule: each upload uses exactly one schema. You can’t send an email and a phone number in the same row or request.

UploadContains
Email batchEMAIL_SHA256 values only
Phone batchPHONE_SHA256 values only
MAID batchMOBILE_AD_ID_SHA256 values only

To reach the same people by email and phone, upload both batches to the same segment. Snapchat matches each identifier independently.

For people with several emails (a work address and personal ones), send all of them in the email batch. Matched users are de-duplicated, so extra emails add match chances, not inflated counts.

X’s UI and Pinterest use the same one-type-per-list model. Meta and TikTok instead take several identifiers in one row.

Phones: Digits Only, No Plus Sign

Snapchat wants phone numbers as digits only, with the country code, without the +, and with any leading trunk zero dropped:

InputSnapchat-ready value
+1 (206) 555-010012065550100
07123 456789 (UK domestic)447123456789
+12065550100✗ (this is Google, X and TikTok’s format)

12065550100 and +12065550100 hash to unrelated values:

InputSHA-256
120655501000000fd214ade3cd6a790d9a949f519b17b7c993625dd4782e14166523c66d415
+12065550100b4fa1a0e9e520f7186de1a00b1b84abb55a5c7feab09e7c3b8059ca32a6abd4f

This is the same format as Meta. If you also advertise on Google, X or TikTok, keep both phone hashes.

Mobile Ad IDs Are Hashed Too

Meta and Google take mobile ad IDs in plain text. Snapchat doesn’t:

  1. Lowercase the ID.
  2. Keep the hyphens.
  3. Hash with SHA-256.
InputSHA-256
38400000-8CF0-11BD-B23E-10B96E40000D → 38400000-8cf0-11bd-b23e-10b96e40000dd4181bb455a74b3bc8b37c75ac9b2c702eb6b9930bd040b861403b31ca85634d

Drop all-zero IDs (00000000-0000-0000-0000-000000000000) before hashing. They mean the user opted out of tracking. Our section on hashed phone numbers, mobile ad IDs and names compares MAID rules across platforms.

Snapchat Marketing API: Uploading Customer Lists

Snapchat’s Marketing API (often called the Snapchat Ads API) manages campaigns, creatives, reporting and audience segments. For customer lists, the workflow is:

  1. Create a segment with source_type set to FIRST_PARTY and a retention_in_days value (the default 9999 means lifetime).
  2. Add users with a POST to /segments/{segment_id}/users, using one schema per request.
  3. Poll the segment until upload_status reads COMPLETE.
  4. Check targetable_status before launching campaigns.

A simplified request body for an email batch:

{
  "users": [
    {
      "schema": ["EMAIL_SHA256"],
      "data": [
        ["f1904cf1a9d73a55fa5de0ac823c4403ded71afd4c3248d00bdcd0866552bb79"],
        ["375320dd9ae7ed408002f3768e16cb5f28c861062fd50dff9a3bff62e9dce4ef"]
      ]
    }
  ]
}

Send up to 100,000 identifiers per request. For phones or MAIDs, make separate requests with PHONE_SHA256 or MOBILE_AD_ID_SHA256.

Clearing a list without deleting it

To empty a segment while keeping its ID (and the campaigns targeting it), call:

DELETE /segments/{segment_id}/all_users

Then upload the fresh list.

Is Your Audience Big Enough?

Snapchat doesn’t publish a fixed minimum audience size. Instead:

  • Wait for upload_status to reach COMPLETE before judging size.
  • Check the segment’s targetable_status. A value of TOO_FEW_USERS means it can’t be targeted yet.

If you see TOO_FEW_USERS, add more identifiers (more emails per person, phone and MAID batches) or combine segments. For reference, other platforms publish their floors: 100 on Google and X, and 1,000 on Reddit and TikTok.

Improving Your Snapchat Match Rate

Fix the format:

  • One schema per request.
  • Lowercase hex.
  • Digits-only phones with country code, no +.
  • Hashed, lowercase MAIDs with hyphens.
  • No Gmail-dot stripping.
  • Remove blanks before hashing. An empty string hashes to e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855.

Then improve the list:

  • Add personal emails and mobile numbers. Snapchat accounts are tied to personal phones and emails, never work addresses. A people data API can find both from a work email or LinkedIn URL.
  • Upload all three identifier types to the same segment where you have them.
  • Prefer mobiles over landlines and direct dials.

A Tested Python Snippet for Snapchat

import hashlib
import re

def sha256_hex(value: str) -> str:
    return hashlib.sha256(value.encode("utf-8")).hexdigest()

def snap_email_hash(email: str) -> str | None:
    e = email.strip().lower()                       # keep Gmail dots
    return sha256_hex(e) if "@" in e else None

def snap_phone_hash(international_number: str) -> str | None:
    digits = re.sub(r"\D", "", international_number)   # drops +, spaces, brackets
    if digits.startswith("00"):
        digits = digits[2:]
    return sha256_hex(digits) if digits else None       # digits only, no +

def snap_maid_hash(maid: str) -> str | None:
    m = maid.strip().lower()                        # keep hyphens
    if not m or m == "00000000-0000-0000-0000-000000000000":
        return None
    return sha256_hex(m)

def snap_batches(people: list[dict]) -> dict:
    """One list per schema, since Snapchat allows one identifier type per request."""
    return {
        "EMAIL_SHA256": sorted({h for p in people for h in map(snap_email_hash, p.get("emails", [])) if h}),
        "PHONE_SHA256": sorted({h for p in people for h in map(snap_phone_hash, p.get("phones", [])) if h}),
        "MOBILE_AD_ID_SHA256": sorted({h for p in people for h in map(snap_maid_hash, p.get("maids", [])) if h}),
    }

assert snap_email_hash("  Mary@Example.com ") == (
    "f1904cf1a9d73a55fa5de0ac823c4403ded71afd4c3248d00bdcd0866552bb79"
)
assert snap_phone_hash("+1 (206) 555-0100") == (
    "0000fd214ade3cd6a790d9a949f519b17b7c993625dd4782e14166523c66d415"
)
assert snap_maid_hash("38400000-8CF0-11BD-B23E-10B96E40000D") == (
    "d4181bb455a74b3bc8b37c75ac9b2c702eb6b9930bd040b861403b31ca85634d"
)

The phone function expects numbers that already include a country code. Convert domestic numbers (like the UK example above) first with the phonenumbers library, which also drops trunk zeros.

Snap Audience Match FAQ

What’s the minimum size for a Snap Audience Match audience?

Snapchat doesn’t publish one. Check the segment’s targetable_status; TOO_FEW_USERS means it’s too small to target.

Can I upload emails and phones together?

Not in the same request. Upload each identifier type separately to the same segment.

Do I hash mobile ad IDs for Snapchat?

Yes. Lowercase them, keep the hyphens, then SHA-256 hash. That’s different from Meta and Google, which take MAIDs in plain text.

Should phone numbers include the plus sign?

No. Snapchat wants digits only with the country code, like Meta.

How long do Snap Audience Match audiences last?

You set retention per segment. The default, 9999, keeps members for the segment’s lifetime.

How do I refresh a list without breaking campaigns?

Clear it with DELETE /segments/{segment_id}/all_users, then upload the new list to the same segment.

Get Snapchat-Ready Hashes with Limadata

Snapchat users sign up with personal phones and emails. A list of work emails will mostly miss.

Limadata’s Ad Audience API takes a LinkedIn URL or work email and returns every hashed identifier we can resolve, including personal emails and mobile numbers in digits-only format, ready to split into Snapchat’s one-schema-per-request batches.

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

Related reading: