Replace all items in an exception list

Replaces the items within an existing exception list by uploading a .CSV/.XLSX file with all items meant for a particular exception list. To update specific items in an exception list, use the create an item for an exception list endpoint with the Upsert parameter.


File optional

A .CSV/.XLSX file containing the column headers found below and the exception list's item's information. One exception list item per row. Cannot use alongside any other parameter.

View column headers
ValuerequiredThe CATEGORY or SKU value that the exception list looks at, depending on the exception list's Type.
NameoptionalItem's display name for contracting purposes.
ActiveStartDateoptionalThe date and time that the item will be added to the exception list. See ISO 8601.
ActiveEndDateoptionalThe date and time that the item will be removed from the exception list. See ISO 8601.
TimeZoneoptionalThe time zone that govern ActiveStartDate and ActiveEndDate. See's supported currencies.


Returns the status of the request and the URI of the exception list item list. Returns an error if create parameters are invalid or if a required parameter is missing.

Example Request

curl '<AccountSID>/ExceptionLists/<ExceptionListId>/Items' \
-u '<AccountSID>:<AuthToken>' \
-H 'Content-Type: multipart/form-data' \
-F '[email protected]"path/to/a/file.csv"'

Example Response

  "Status": "OK",
  "Uri": "/Advertisers/<AccountSID>/ExceptionLists/10002/Items/"