Upload a hashed customer list to build a Snapchat Customer Lists audience

domain: developers.snap.com · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Create an audience segment: POST /v1/adaccounts/{ad_account_id}/segments with source_type FIRST_PARTY.
  2. Normalize identifiers before hashing: trim and lowercase emails, and strip leading zeros and non-digit characters from phone numbers while including the country code.
  3. Hash each normalized value with SHA-256 and lowercase-hex encode it.
  4. POST /v1/segments/{segment_id}/users with schema set to one identifier type (e.g. EMAIL_SHA256) and data as the array of hashes — one schema type per request.
  5. Poll the segment's upload_status and targetable_status fields until targetable_status reports READY before using it for targeting.
  6. Use DELETE on the same endpoint to remove specific users, or DELETE /segments/{segment_id}/all_users to clear the whole list.

Known gotchas

Related routes

build a snapchat custom audience from hashed customer data via snap audience match
developers.snap.com/api/marketing-api · 5 steps · unrated
Upload a hashed customer list and build a Customer List audience via the Pinterest Ads API
developers.pinterest.com/docs · 5 steps · unrated
Upload a hashed customer list to Meta as a Custom Audience for ad targeting
developers.facebook.com/docs/marketing-api · 6 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans