Snap App ID

The Snap App ID is a unique ID set up by an advertiser to verify ownership of their apps, the Snap App ID maps to iOS and/or Android and is used for both App Install marketing and re-engagement via the Deep Link ad format.

Setting the Snap App ID

The Snap App ID is set up via Snap Business Manager using the App name and the app identifiers from the iOS Apple store (numerical value) and the Google Play Store (eg "com.x.y"), if you wish to share events with an MMP you can pick the MMP within the Snap App settings.

Once your Snap App ID has been set up via Snap Business Manager a Snap App entity will have been created under your Organization, it's possible to fetch this entity via an API request.

Snap App entity attributes

Attribute	Description	Required	Possible Values
id	Snap App ID	Read-only
name	App name	Read-only
ios_app_id	iOS App ID	Read-only	numerical value from the Apple app store
ios_app_id_verified	iOS verification status	Read-only	true
android_app_url	Google Play store ID	Read-only	eg "com.x.y"
android_app_url_verified	Android verification status	Read-only	true

Get all Snap Apps under an Organization

curl "https://adsapi.snapchat.com/v1/organizations/8fdeefec-f502-4ca8-9a84-6411e0a51098/mobile_apps?limit=200" \
  -H "Authorization: Bearer meowmeowmeow"

The above command returns JSON structured like this:

{
  "request_status": "SUCCESS",
  "request_id": "6005af2e00ff056460e3b8f73e0001737e616473617069736300016275696c642d34343839623532342d312d3431342d3000010142",
  "paging": {},
  "mobile_apps": [
    {
      "sub_request_status": "SUCCESS",
      "mobile_app": {
        "id": "07b517bb-9cdb-42ef-ba77-9dd9a9eb2dc8",
        "updated_at": "2020-05-28T12:17:48.744Z",
        "created_at": "2020-05-28T12:17:01.757Z",
        "container_kind": "Organizations",
        "container_id": "8fdeefec-f502-4ca8-9a84-6411e0a51098",
        "name": "The Kitty Cat App",
        "visible_to": [
          "OrganizationEntity_8fdeefec-f502-4ca8-9a84-6411e0a51098",
          "AdAccountEntity_82225ba6-7559-4000-9663-bace8adff5f8"
        ]
      }
    },
    {
      "sub_request_status": "SUCCESS",
      "mobile_app": {
        "id": "9b5b83ec-c593-4a64-9c6d-a0eb9da0edb9",
        "updated_at": "2020-12-08T22:33:32.204Z",
        "created_at": "2020-09-29T22:33:48.661Z",
        "container_kind": "Organizations",
        "container_id": "8fdeefec-f502-4ca8-9a84-6411e0a51098",
        "name": "The Badger tunneling app",
        "visible_to": [
          "OrganizationEntity_8fdeefec-f502-4ca8-9a84-6411e0a51098",
          "AdAccountEntity_82225ba6-7559-4000-9663-bace8adff5f8"
        ],
        "ios_app_id": "444433333",
        "ios_app_id_verified": true,
        "android_app_url": "com.badgertunneling.android"
      }
    }
  ]
}

This endpoint retrieves all Mobile Apps under an Organization.

HTTP Request

GET https://adsapi.snapchat.com/v1/organizations/{organization_id}/mobile_apps

Parameters

Parameter	Default	Description
ad_account_id		Ad Account ID
limit		integer, min 50, max 1000

Get all Snap Apps under an Ad Account

curl "https://adsapi.snapchat.com/v1/adaccounts/7ebc489b-2120-47ed-95f8-3fe1b26ca997/mobile_apps" \
  -H "Authorization: Bearer meowmeowmeow"

The above command returns JSON structured like this:

{
  "request_status": "SUCCESS",
  "request_id": "60abc6ea00ff0a33fdabf6a9c00001737e616473617069736300016275696c642d37356261303735372d312d3434392d3200010119",
  "paging": {},
  "mobile_apps": [
    {
      "sub_request_status": "SUCCESS",
      "mobile_app": {
        "id": "e1956376-a963-4000-8e54-84461bf59388",
        "updated_at": "2021-05-07T12:35:57.591Z",
        "created_at": "2021-04-23T13:01:46.816Z",
        "container_kind": "Organizations",
        "container_id": "7fdeefec-f502-4ca8-9a84-6411e0a51057",
        "name": "Badger Mates",
        "ios_app_id": "9876543210",
        "android_app_url": "com.badger",
        "mobile_measurement_partners": ["ADJUST"]
      }
    },
    {
      "sub_request_status": "SUCCESS",
      "mobile_app": {
        "id": "8b5b83ec-c593-4a64-9c6d-a0eb9da0edba",
        "updated_at": "2021-03-19T07:45:53.009Z",
        "created_at": "2020-09-29T22:33:48.661Z",
        "container_kind": "Organizations",
        "container_id": "7fdeefec-f502-4ca8-9a84-6411e0a51058",
        "name": "Badger Timber Supplies",
        "ios_app_id": "1234567890",
        "ios_app_id_verified": true,
        "android_app_url": "com.badgerexample.android",
        "mobile_measurement_partners": ["APPSFLYER", "KOCHAVA"]
      }
    }
  ]
}

This endpoint retrieves all Mobile Apps associated with an Ad Account.

HTTP Request

GET https://adsapi.snapchat.com/v1/adaccounts/{adaccount_id}/mobile_apps

Parameters

Parameter	Default	Description
ad_account_id		Ad Account ID

Get a specific Snap App

curl "https://adsapi.snapchat.com/v1/mobile_apps/9b5b83ec-c593-4a64-9c6d-a0eb9da0edb9" \
  -H "Authorization: Bearer meowmeowmeow"

The above command returns JSON structured like this:

{
  "request_status": "SUCCESS",
  "request_id": "6005afef00ff00ff53c3310c98d70001737e616473617069736300016275696c642d34343839623532342d312d3431342d3000010147",
  "mobile_apps": [
    {
      "sub_request_status": "SUCCESS",
      "mobile_app": {
        "id": "9b5b83ec-c593-4a64-9c6d-a0eb9da0edb9",
        "updated_at": "2020-12-08T22:33:32.204Z",
        "created_at": "2020-09-29T22:33:48.661Z",
        "container_kind": "Organizations",
        "container_id": "8fdeefec-f502-4ca8-9a84-6411e0a51098",
        "name": "The Badger tunneling app",
        "visible_to": [
          "OrganizationEntity_8fdeefec-f502-4ca8-9a84-6411e0a51098",
          "AdAccountEntity_82225ba6-7559-4000-9663-bace8adff5f8"
        ],
        "ios_app_id": "444433333",
        "ios_app_id_verified": true,
        "android_app_url": "com.badgertunneling.android",
        "android_app_url_verified": true
      }
    }
  ]
}

This endpoint retrieves a specific Mobile App.

HTTP Request

GET https://adsapi.snapchat.com/v1/mobile_apps/{mobile_app_id}

Parameters

Parameter	Default	Description
snap_app_id		Mobile App ID