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 |