Update a List

This endpoint allows you to upload a file update to an existing list in the account.


Name Parameter
Data Type Description
Authorization: Header False Required String Insert your generated access token.
(Bearer {access token})
listid Path False Required String Specify the ID of the list being updated.
headings Form False Optional String Does the first row of the source data contain a heading?
fieldseparator Form False Optional String Set field separator character
quotecharacter Form False Required String Set field quote character
uploadspecs Form False Required String A JSON formatted object to describe the structure of the list that is being uploaded.
mergespecs Form False Required String A JSON formatted object to describe the structure of how the list is merged.
putEmptyValues Form False Optional String Do you want values in the destination list to be overwritten by blanks if the source list is blank for the corresponding column?
("Y", "N")
Body False Required File The output file in CSV format.

Parameter Notes


Please see the uploadspecs page to learn how to format your uploadspecs.


Please see the mergespecs page to learn how to format your mergespecs.


Code Examples


Grant Type Password
Grant Type Code
Grant Type Refresh
Account API
Get Account Information
Create New Account User(s)
Delete Account User(s)
Delete Account User by Email
Get email senders
Fact API
Upload Custom Event
Get Custom Event Upload Status
List API
Get List of Assets
Download a List
Create a New List
Update a List
Get List Upload Status
Get List Rejected Records
Delete a List
Delete Records from List
Get Hard Bounce List
Get Spam Complaint List
Get Opt-Out List
Update Out-Out List
Get Opt-Outs by Subscription Category
Content API
Get Logo List
Get a Logo
Add a Logo
Update a Logo
Delete a Logo
Get Header List
Get a Header
Add a Header
Update a Header
Delete a Header
Get Footer List
Get a Footer
Add a Footer
Delete a Footer
Update a Footer
Get Image List
Get an Image
Add an Image
Update an Image
Delete an Image
Get Media List
Get Media File
Add a Media File
Add a Media Link
Update Media File
Delete a Media Object
Get Form List
Get Classic Form URLS
Get Landing Page List
Get Landing Page
Delete Landing Page
Get Landing Page URLs
Get List of Programs
Reporting API
Get Message Report
Get Message Report Drilldown
Get Message Report by Time Period
Get Media Report
Get Media Message Report
Get a Media Report Drilldown
Get a Media Timeline Report
Get Form Report
Get Landing Page Report
Email Campaign API
Get Message List
Send a Message
Resend a message
Add new template or draft message
Update template or draft message
Delete a Message
Get Message Report
Get Message Report Drilldown
Get Message Report by Time Period
Get Message HTML
Contact API
Add a Contact
Get Contact Record
Upsert a contact record by email
Update a contact by record ID
Delete a contact
Get contact record ID based on cookie value
Get contact from list based on cookie ID or e-mail
Get contact fact and score data
Get subscription categories
Opt in/Opt out subscription category by email address
Get subscription category opt-ins by email
Opt in/Opt out multiple subscription categories by email address
Get SEO keywords
Get a new SEO report
Frequently Asked Questions