Audit Logs

For certain entities you can retrieve change logs which allows you to see all the changes made to the entity. You should always use pagination when fetching change logs for an entity.

Entities supported right now are Campaign, AdSquad, Ad, Creative and Dynamic Templates. Change logs are only availabe from the 16 July 2019 and onwards.

Fetch the change logs for a Campaign

curl "https://adsapi.snapchat.com/v1/campaigns/{campaign_id}/external_changelogs?limit=50" \
  -H "Authorization: Bearer meowmeowmeow"

The above command returns JSON structured like this:

{
  "request_status": "SUCCESS",
  "request_id": "5d2f4a2e00ff0b2d2797e383a20001737e616473617069736300016275696c642d32613361333938642d312d3237332d3100010126",
  "paging": {},
  "changelogs": [
    {
      "sub_request_status": "SUCCESS",
      "changelog": {
        "id": "f9fd14cf-1bb0-4592-beeb-9d7e358e746b",
        "updated_at": "2019-07-17T16:17:30.194Z",
        "created_at": "2019-07-17T16:17:30.194Z",
        "name": "Badger Campaign - July 2019",
        "action": "UPDATED",
        "user_id": "a71cfcae-895d-4314-9460-e2ffd2515dd0",
        "email": "honey.badger@hooli.com",
        "event_at": "2019-07-17T16:17:29.991Z",
        "app_id": "87947032-5fbd-46a7-ba60-073ca8efefbb",
        "app_name": "Honey badger App",
        "entity_id": "dcc3f407-7049-47aa-8300-6cce946ed04e",
        "entity_type": "CAMPAIGN",
        "update_value_records": {
          "status": {
            "before_value": "\"ACTIVE\"",
            "after_value": "\"PAUSED\""
          }
        }
      }
    },
    {
      "sub_request_status": "SUCCESS",
      "changelog": {
        "id": "3cd457c6-077d-4d4b-9647-73a97045e709",
        "updated_at": "2019-07-17T15:54:59.955Z",
        "created_at": "2019-07-17T15:54:59.955Z",
        "name": "Badger Campaign - July 2019",
        "action": "UPDATED",
        "user_id": "a71cfcae-895d-4314-9460-e2ffd2515dd0",
        "email": "honey.badger@hooli.com",
        "event_at": "2019-07-17T15:54:59.755Z",
        "app_id": "87947032-5fbd-46a7-ba60-073ca8efefbb",
        "app_name": "Honey badger App",
        "entity_id": "dcc3f407-7049-47aa-8300-6cce946ed04e",
        "entity_type": "CAMPAIGN",
        "update_value_records": {
          "end_time": {
            "after_value": "1563580491000"
          }
        }
      }
    }
  ]
}

This endpoint retrieves the latest 50 changes to the Campaign entity.

HTTP Request

GET https://adsapi.snapchat.com/v1/campaigns/{campaign_id}/external_changelogs?limit=50

Parameters

Parameter	Default	Description
campaign_id		Campaign ID

Fetch the change logs for an AdSquad

curl "https://adsapi.snapchat.com/v1/adsquads/{adsquad_id}/external_changelogs?limit=50" \
  -H "Authorization: Bearer meowmeowmeow"

The above command returns JSON structured like this:

{
  "request_status": "SUCCESS",
  "request_id": "5d2f495400ff05e47e72eb0f710001737e616473617069736300016275696c642d32613361333938642d312d3237332d310001011a",
  "paging": {},
  "changelogs": [
    {
      "sub_request_status": "SUCCESS",
      "changelog": {
        "id": "ae2161fb-737a-4f3c-9a3d-e6c83d9c9e30",
        "updated_at": "2019-07-17T15:58:40.150Z",
        "created_at": "2019-07-17T15:58:40.150Z",
        "name": "Badger Ad Squad - July 2019",
        "action": "UPDATED",
        "user_id": "a71cfcae-895d-4314-9460-e2ffd2515dd0",
        "email": "honey.badger@hooli.com",
        "event_at": "2019-07-17T15:58:39.872Z",
        "app_id": "e9bdc78d-81fa-4470-8f6b-2a3d6f0487b3",
        "app_name": "Honey badger App",
        "entity_id": "c478150d-b177-4ecb-938d-f5157375f937",
        "entity_type": "AD_SQUAD",
        "update_value_records": {
          "bid_micro": {
            "before_value": "868402",
            "after_value": "876174"
          }
        }
      }
    }
  ]
}

This endpoint retrieves the latest 50 changes to the AdSquad entity.

HTTP Request

GET https://adsapi.snapchat.com/v1/adsquads/{adsquad_id}/external_changelogs?limit=50

Parameters

Parameter	Default	Description
adsquad_id		AdSquad ID

Fetch the change logs for an Ad

curl "https://adsapi.snapchat.com/v1/ads/{ad_id}/external_changelogs?limit=50" \
  -H "Authorization: Bearer meowmeowmeow"

The above command returns JSON structured like this:

{
  "request_status": "SUCCESS",
  "request_id": "5d39e22900ff08cd2599670abb0001737e616473617069736300016275696c642d30633939333234362d312d3237352d300001014c",
  "paging": {},
  "changelogs": [
    {
      "sub_request_status": "SUCCESS",
      "changelog": {
        "id": "36f4b88b-1c24-41f5-af86-24983795edd7",
        "updated_at": "2019-07-25T17:08:51.279Z",
        "created_at": "2019-07-25T17:08:51.279Z",
        "name": "Badger Holiday Ad 2019",
        "action": "UPDATED",
        "user_id": "a71cfcae-895d-4314-9460-e2ffd2515dd0",
        "email": "honey.badger@hooli.com",
        "event_at": "2019-07-25T17:08:51.030Z",
        "app_id": "87947032-5fbd-46a7-ba60-073ca8efefbb",
        "app_name": "Honey badger App",
        "entity_id": "cd88b368-35a3-46f4-b37f-2f1a72db2692",
        "entity_type": "AD",
        "update_value_records": {
          "status": {
            "before_value": "\"ACTIVE\"",
            "after_value": "\"PAUSED\""
          }
        }
      }
    }
  ]
}

This endpoint retrieves the latest 50 changes to the Ad entity.

HTTP Request

GET https://adsapi.snapchat.com/v1/ads/{ad_id}/external_changelogs?limit=50

Parameters

Parameter	Default	Description
ad_id		Ad ID

Fetch the change logs for a Creative

curl "https://adsapi.snapchat.com/v1/creatives/{creative_id}/external_changelogs?limit=50" \
  -H "Authorization: Bearer meowmeowmeow"

The above command returns JSON structured like this:

{
  "request_status": "SUCCESS",
  "request_id": "5d39de6000ff01c2268bd5c37b0001737e616473617069736300016275696c642d30633939333234362d312d3237352d300001010a",
  "paging": {},
  "changelogs": [
    {
      "sub_request_status": "SUCCESS",
      "changelog": {
        "id": "a94cb9ed-0171-402a-aee7-ffecae0ce7bc",
        "updated_at": "2019-07-17T16:27:00.717Z",
        "created_at": "2019-07-17T16:27:00.717Z",
        "name": "Badger Rush",
        "action": "UPDATED",
        "user_id": "a71cfcae-895d-4314-9460-e2ffd2515dd0",
        "email": "honey.badger@hooli.com",
        "event_at": "2019-07-17T16:27:00.566Z",
        "app_id": "e9bdc78d-81fa-4470-8f6b-2a3d6f0487b3",
        "app_name": "Honey Badger App",
        "entity_id": "6475383b-cb70-4353-93b2-b227054169ae",
        "entity_type": "CREATIVE",
        "update_value_records": {
          "call_to_action": {
            "before_value": "\"MORE\"",
            "after_value": "\"SIGN UP\""
          }
        }
      }
    },
    {
      "sub_request_status": "SUCCESS",
      "changelog": {
        "id": "72b18e3a-598a-4e29-a288-980613de3714",
        "updated_at": "2019-07-17T16:07:00.985Z",
        "created_at": "2019-07-17T16:07:00.985Z",
        "name": "Badger Rush",
        "action": "CREATED",
        "user_id": "a71cfcae-895d-4314-9460-e2ffd2515dd0",
        "email": "honey.badger@hooli.com",
        "event_at": "2019-07-17T16:07:00.629Z",
        "app_id": "e9bdc78d-81fa-4470-8f6b-2a3d6f0487b3",
        "app_name": "Honey Badger App",
        "entity_id": "6475383b-cb70-4353-93b2-b227054169ae",
        "entity_type": "CREATIVE"
      }
    }
  ]
}

This endpoint retrieves the latest 50 changes to the Creative entity.

HTTP Request

GET https://adsapi.snapchat.com/v1/creatives/{creative_id}/external_changelogs?limit=50

Parameters

Parameter	Default	Description
creative_id		Creative ID

Fetch the change logs for a Dynamic Template

curl "https://adsapi.snapchat.com/v1/dynamic_templates/{dynamic_template_id}/external_changelogs?limit=50" \
  -H "Authorization: Bearer meowmeowmeow"

The above command returns JSON structured like this:

{
  "request_status": "SUCCESS",
  "request_id": "5d39e22900ff08cd2599670abb0001737e616473617069736300016275696c642d30633939333234362d312d3237352d300001014c",
  "paging": {},
  "changelogs": [
    {
      "sub_request_status": "SUCCESS",
      "changelog": {
        "id": "4f5f0eb1-92dd-4ae4-9d86-135ca516e696",
        "updated_at": "2023-10-17T19:28:18.445Z",
        "created_at": "2023-10-17T19:28:18.445Z",
        "name": "Badger template",
        "action": "CREATED",
        "email": "honey.badger@hooli.com",
        "event_at": "2023-10-17T19:28:17.912Z",
        "app_id": "e9bdc78d-81fa-4470-8f6b-2a3d6f0487b3",
        "app_name": "Honey badger App",
        "entity_id": "f0a30c08-7613-4d41-a5fa-d8a0382bcced",
        "entity_type": "DYNAMIC_TEMPLATE"
      }
    }
  ]
}

This endpoint retrieves the latest 50 changes to the Dynamic Template entity.

HTTP Request

GET https://adsapi.snapchat.com/v1/dynamic_templates/{dynamic_template_id}/external_changelogs?limit=50

Parameters

Parameter	Default	Description
dynamic_template_id		Dynamic Template ID

Was this page helpful?

Yes

Fetch the change logs for a Campaign​

HTTP Request​

Parameters​

Fetch the change logs for an AdSquad​

HTTP Request​

Parameters​

Fetch the change logs for an Ad​

HTTP Request​

Parameters​

Fetch the change logs for a Creative​

HTTP Request​

Parameters​

Fetch the change logs for a Dynamic Template​

HTTP Request​

Parameters​

Fetch the change logs for a Campaign

HTTP Request

Parameters

Fetch the change logs for an AdSquad

HTTP Request

Parameters

Fetch the change logs for an Ad

HTTP Request

Parameters

Fetch the change logs for a Creative

HTTP Request

Parameters

Fetch the change logs for a Dynamic Template

HTTP Request

Parameters