Skip to main content

Event Details

The Event Details entity specifies an event to be used the Reminder type Creative, this entity is immutable once created, none of the attributes can be edited.

The event start time is in UTC timing by default, you will need to add or subtract hours to fit timings in other time zones, also taking daylight savings into account.

Event Details Attributes​

AttributeDescriptionRequiredPossible Values
event_nameRMax length 300 characters
event_time_zoneThe event_time_zone is an optional parameter which is only used for display purposes by Snap Ads Manager, if this attribute is left out it will default to the time zone of the Ad AccountOAfrica/Cairo, Africa/Johannesburg, America/Anchorage, America/Cancun, America/Chicago, America/Dawson, America/Dawson_Creek, America/Denver, America/Edmonton, America/Halifax, America/Hermosillo, America/Los_Angeles, America/Mazatlan, America/Mexico_City, America/Montevideo, America/New_York, America/Phoenix, America/Rainy_River, America/Regina, America/Tijuana, America/Toronto, America/Vancouver, Asia/Amman, Asia/Beirut, Asia/Dubai, Asia/Hong_Kong, Asia/Irkutsk, Asia/Jerusalem, Asia/Kamchatka, Asia/Krasnoyarsk, Asia/Magadan, Asia/Nicosia, Asia/Omsk, Asia/Qatar, Asia/Riyadh, Asia/Shanghai, Asia/Singapore, Asia/Vladivostok, Asia/Yakutsk, Asia/Yekaterinburg, Atlantic/Canary, Australia/Perth, Australia/Sydney, Europe/Amsterdam, Europe/Berlin, Europe/Brussels, Europe/Dublin, Europe/Helsinki, Europe/Istanbul, Europe/Kaliningrad, Europe/London, Europe/Luxembourg, Europe/Madrid, Europe/Malta, Europe/Moscow, Europe/Oslo, Europe/Paris, Europe/Rome, Europe/Samara, Europe/Stockholm, Europe/Vienna, Europe/Vilnius, Europe/Warsaw, Europe/Zurich, Pacific/Auckland, Pacific/Honolulu, UTC
event_start_timeStart date in ISO code format, year, month, day, hour (optional), minutes(optional), seconds(optional). The date is in UTC you will need to offset the date to match the region the event is located in, the delimiter between day and hour in the date needs to be a T character.RExample; 2025-11-16T09:00:00 - Event starts at 16 November 4am Eastern time
ad_account_idThe Ad Account where the event details livesR

Create an Event Details entity​

This endpoint will create an Event Details entity within a specified ad account.

HTTP Request​

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

Parameters​

ParameterDefaultDescription
ad_account_idAd Account ID
curl -X POST \
  -H "Authorization: Bearer meowmeowmeow" \
  -H "Content-Type: application/json" \
   -d '{"event_details":[{"event_name": "Poodle Show Launch","event_time_zone": "America/New_York","event_start_time": "2025-11-16T00:00:00-04:00:00,"ad_account_id": "82225ba6-7559-4000-9663-bace8adff5f8"}]}' \
   "https://adsapi.snapchat.com/v1/adaccounts/82225ba6-7559-4000-9663-bace8adff5f8/event_details"

The above command returns JSON structured like this:

{
  "request_status": "SUCCESS",
  "request_id": "082bcf55-c594-4de8-a944-aee8e2986cff",
  "event_details": [
    {
      "sub_request_status": "SUCCESS",
      "event_detail": {
        "id": "b762edbd-7f9b-44ea-8dd0-f9f3e6405aec",
        "updated_at": "2025-03-18T11:38:04.359Z",
        "created_at": "2025-03-18T11:38:04.359Z",
        "event_name": "Poodle Show Launch",
        "event_start_time": "2025-11-16T04:00:00.000Z",
        "event_time_zone": "America/New_York",
        "ad_account_id": "82225ba6-7559-4000-9663-bace8adff5f8"
      }
    }
  ]
}

Get an Event Details entity​

This endpoint retrieves a specific Event Details entity.

HTTP Request​

GET https://adsapi.snapchat.com/v1/event_details/{event_details_id}

URL Parameters​

ParameterDefaultDescription
event_details_idEvent Details ID
curl "https://asapi.snapchat.com/v1/event_details/5ec9b3d8-8ad7-4375-a835-16f21742823e" \
  -H "Authorization: Bearer  meowmeowmeow"

The above command returns JSON structured like this:

{
  "request_status": "SUCCESS",
  "request_id": "7ce99e05-cd84-43f1-a138-11cb6200465f",
  "event_details": [
    {
      "sub_request_status": "SUCCESS",
      "event_detail": {
        "id": "5ec9b3d8-8ad7-4375-a835-16f21742823e",
        "updated_at": "2025-02-24T16:12:55.747Z",
        "created_at": "2025-02-24T16:12:55.747Z",
        "event_name": "Squirrels Motion Picture launch",
        "event_start_time": "2025-12-10T10:00:00.000Z",
        "event_time_zone": "America/New_York",
        "ad_account_id": "82225ba6-7559-4000-9663-bace8adff5f8"
      }
    }
  ]
}

Get all Event Details entities under an Ad Account​

This endpoint retrieves all Event Details entities under an Ad Account.

HTTP Request​

GET https://adsapi.snapchat.com/v1/adaccounts/{ad_account_id}/event_details

URL Parameters​

ParameterDefaultDescription
ad_account_idAd Account ID
curl "https://adsapi.snapchat.com/v1/adaccounts/82225ba6-7559-4000-9663-bace8adff5f8/event_details" \
  -H "Authorization: Bearer  meowmeowmeow"

The above command returns JSON structured like this:

   "request_status": "SUCCESS",
   "request_id": "43499453-db00-4574-aef4-60dc39f0f6bb",
   "paging": {},
   "event_details": [
       {
           "sub_request_status": "SUCCESS",
           "event_detail": {
               "id": "5ec9b3d8-8ad7-4375-a835-16f21742823e",
               "updated_at": "2025-02-24T16:12:55.747Z",
               "created_at": "2025-02-24T16:12:55.747Z",
               "event_name": "Squirrels Motion Picture launch",
               "event_start_time": "2025-12-10T10:00:00.000Z",
               "event_time_zone": "America/New_York",
               "ad_account_id": "82225ba6-7559-4000-9663-bace8adff5f8"
           }
       },
       {
           "sub_request_status": "SUCCESS",
           "event_detail": {
               "id": "b762edbd-7f9b-44ea-8dd0-f9f3e6405aec",
               "updated_at": "2025-03-18T11:38:04.359Z",
               "created_at": "2025-03-18T11:38:04.359Z",
               "event_name": "Poodle Show Launch",
               "event_start_time": "2025-11-16T04:00:00.000Z",
               "event_time_zone": "America/New_York",
               "ad_account_id": "82225ba6-7559-4000-9663-bace8adff5f8"
           }
       }
   ]
}

Delete an Event Details entity​

This endpoint deletes a specific Event Details entity, we recommend that you use this endpoint with caution as there is no way to reinstate a deleted entity. Before you delete an Event Details entity you should always make sure it's not being used by an active Reminder Creative.

HTTP Request​

DELETE https://adsapi.snapchat.com/v1/event_details/{event_details_id}

URL Parameters​

ParameterDescription
event_details_idThe ID of the Event Details entity to be deleted
curl -X DELETE "https://adsapi.snapchat.com/v1/event_details/7ded6d53-0805-4ff8-b984-54a7eb5c8918" \
  -H "Authorization: Bearer meowmeowmeow"

The above command returns JSON structured like this:

{
  "request_status": "success",
  "request_id": "57b01b6200ff05d100ff30ca9b1d0001737e616473617069736300016275696c642d35396264653638322d312d31312d3700010101",
  "ads": []
}
Was this page helpful?
Yes
No