Snapchat · Schema

UserData

User identification data for matching conversion events to Snapchat users. All personally identifiable information should be hashed using SHA-256 before sending.

AdvertisingARAugmented RealityMarketingMessagingSocial-Media

Properties

Name	Type	Description
em	string	SHA-256 hashed lowercase email address of the user.
ph	string	SHA-256 hashed phone number in E.164 format.
fn	string	SHA-256 hashed lowercase first name of the user.
ln	string	SHA-256 hashed lowercase last name of the user.
ge	string	SHA-256 hashed gender (m or f).
db	string	SHA-256 hashed date of birth in YYYYMMDD format.
ct	string	SHA-256 hashed lowercase city name.
st	string	SHA-256 hashed lowercase two-letter state code.
zp	string	SHA-256 hashed five-digit zip code.
country	string	SHA-256 hashed lowercase two-letter country code.
external_id	string	SHA-256 hashed external ID for the user.
client_ip_address	string	The IP address of the user's browser or device.
client_user_agent	string	The user agent string of the user's browser.
sc_click_id	string	The Snapchat click ID from the ad click URL parameter.
sc_cookie1	string	The Snapchat first-party cookie value.
idfv	string	iOS identifier for vendor.
idfa	string	iOS identifier for advertisers.
madid	string	Mobile advertising device ID (Android).

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/UserData",
  "title": "UserData",
  "type": "object",
  "description": "User identification data for matching conversion events to Snapchat users. All personally identifiable information should be hashed using SHA-256 before sending.",
  "properties": {
    "em": {
      "type": "string",
      "description": "SHA-256 hashed lowercase email address of the user."
    },
    "ph": {
      "type": "string",
      "description": "SHA-256 hashed phone number in E.164 format."
    },
    "fn": {
      "type": "string",
      "description": "SHA-256 hashed lowercase first name of the user."
    },
    "ln": {
      "type": "string",
      "description": "SHA-256 hashed lowercase last name of the user."
    },
    "ge": {
      "type": "string",
      "description": "SHA-256 hashed gender (m or f)."
    },
    "db": {
      "type": "string",
      "description": "SHA-256 hashed date of birth in YYYYMMDD format."
    },
    "ct": {
      "type": "string",
      "description": "SHA-256 hashed lowercase city name."
    },
    "st": {
      "type": "string",
      "description": "SHA-256 hashed lowercase two-letter state code."
    },
    "zp": {
      "type": "string",
      "description": "SHA-256 hashed five-digit zip code."
    },
    "country": {
      "type": "string",
      "description": "SHA-256 hashed lowercase two-letter country code."
    },
    "external_id": {
      "type": "string",
      "description": "SHA-256 hashed external ID for the user."
    },
    "client_ip_address": {
      "type": "string",
      "description": "The IP address of the user's browser or device."
    },
    "client_user_agent": {
      "type": "string",
      "description": "The user agent string of the user's browser."
    },
    "sc_click_id": {
      "type": "string",
      "description": "The Snapchat click ID from the ad click URL parameter."
    },
    "sc_cookie1": {
      "type": "string",
      "description": "The Snapchat first-party cookie value."
    },
    "idfv": {
      "type": "string",
      "description": "iOS identifier for vendor."
    },
    "idfa": {
      "type": "string",
      "description": "iOS identifier for advertisers."
    },
    "madid": {
      "type": "string",
      "description": "Mobile advertising device ID (Android)."
    }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this

find_json_schemasBrowse and filter every JSON Schema in the catalog.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This JSON Schema

curl "https://apis.io/api/v1/json-schemas/snapchat-userdata"

All schemas

curl "https://apis.io/api/v1/json-schemas?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.