Ad Codes

Ad Codes allow creators and brands to easily collaborate on paid partnerships content at a post level. Ad code is generated when a creator creates a piece of content on Snapchat. When this ad code is shared with a brand the brand can then use this code to check the status of the media/content and then create an ad using this piece of content.

Get Media By Ad Code

Claim a specific media using the ad code shared by creator

Parameters

Parameter	Required	Data Type	Description
ad_code	Yes	String	The ad code shared by the creators
profile_id	Yes	String	The profile id of advertiser/brand

Request

POST https://adsapi.snapchat.com/v1/adaccounts/{ad_account_id}/claim_media_by_ad_code

Response

{
    "request_status": "SUCCESS",
    "request_id": "d8943beb-7c3c-4522-8d4e-df7b8f0dbca9",
    "media_entity_id": "d645bac7-e310-4fb2-8481-98842d254a75",
    "error_messages": {}
}

Check media status

Use the media_entity_id received in step and verify its readiness.

Request

GET https://adsapi.snapchat.com/v1/media/{media_id}

Response

{
    "request_status": "SUCCESS",
    "request_id": "2aa5fdca-6087-457a-aa62-23c3bb89b3f5",
    "media": [
        {
            "sub_request_status": "SUCCESS",
            "media": {
                "id": "d645bac7-e310-4fb2-8481-98842d254a75",
                "updated_at": "2024-08-08T20:31:46.268Z",
                "created_at": "2024-08-08T20:31:40.777Z",
                "ad_account_id": "19500815-b276-466a-8a4c-f890554ac1b3",
                "type": "VIDEO",
                "media_status": "READY",
                "download_link": … ,
               …
                "target_business_profile_id": "73329e8b-108e-4a33-9218-183bbbeaa452"
            }
        }
    ]
}

A "media_status": "READY" means the media is ready to be used for ad creation. Otherwise it would show "PENDING_UPLOAD"

Create ad

Use the Media Id as the top_snap_media_id to set up a Creative that shows the creator’s profile

Parameters

Parameter	Required	Data Type	Description
top_snap_media_id	Yes	String	The Media id acquired from previous steps
creator_profile_properties	No	String	The profile id of the creator of the snap, if left null, creative will show brand’s profile
profile_tagged_in_headline	No	String	To get the brand tagged, add this parameter with brand’s profile id

For comprehensive list of all parameters needed for this request, please refer to our docs.

Request

POST https://adsapi.snapchat.com/v1/adaccounts/{ad_account_id}/creatives

Response

{
  "request_status": "success",
  "request_id": "57b0136f00ff085e3d63d358a20001737e616473617069736300016275696c642d35396264653638322d312d31312d3700010108",
  "creatives": [
    {
      "sub_request_status": "success",
      "creative": {
        "id": "c1e6e929-acec-466f-b023-852b8cacc18f",
        "updated_at": "2016-08-14T06:45:04.300Z",
        "created_at": "2016-08-14T06:45:04.300Z",
        "name": "Creative Creative",
        "ad_account_id": "8adc3db7-8148-4fbf-999c-8d2266369d74",
        "type": "SNAP_AD",
        "packaging_status": "PENDING",
        "review_status": "PENDING_REVIEW",
        "shareable": true,
        "top_snap_media_id": "a7bee653-1865-41cf-8cee-8ab85a205837",
        "top_snap_crop_position": "MIDDLE"
      }
    }
  ]
}