Create a new list

Create a new list in your account.


Name Parameter
Data Type Description
Authorization: Header false required String (Bearer {access token}) Pass the authentication token that was granted when you authorized access.
listname form false required string The list name to display in the UI.
foldername form false optional string Name of folder that contains the list. If left blank, the list goes into the Default Folder. If the folder does not exist it will be created.
headings form false Optional String "Y" or "N" for if the first row of the file are headings. Default value is "Y". Any non-null value other than "Y" will be treated as "N".
fieldseparator form false Optional String ("COMMA", "TAB", "SEMI") Character used around fields--valid values: "COMMA", "TAB", "SEMI". If not specified then the field separator value is determined by inspecting the file upload data.
uploadspecs form false required String When creating a new list, uploadSpecs is used to describe the structure of the list you are creating in Act-On.*
file Body false optional File The file to upload (in CSV format).
quotecharacter form false required String ("NONE", "SINGLE_QUOTE", "DOUBLE_QUOTE") Specify the type of quotes used around field names. Valid values: "NONE", "SINGLE_QUOTE", "DOUBLE_QUOTE"

*Note: See uploadspecs


Following are example requests:



A successful request results in an HTTP 200 response with a JSON object with the list listing.

An example JSON response:

When you use a file upload to create a list, the job id is returned. To get the upload status, send a request using this job id:

This returns a JSON object similar to the following. If the list was uploaded successfully, the list id is returned along with the number of appended, updated, failed and rejected records.

If you do not include a file in your POST request, an empty list is created and the list id is returned.

Code Examples

Grant Type Password
Grant Type Code
Grant Type Refresh
Account API
Get Account Information
Create New Account User
Delete account users
Delete account user
Get email senders
Fact API
Upload custom events
Get upload custom event status
List API
Get listing of lists
Download a list
Create a new list
Update or merge a list
Get list upload status
Get rejected records from an upload
Delete a list
Delete records from a list
Get hard bounce list
Get spam complaint list
Get Opt-Out List
Update Out-Out List
Get Subscription Opt-Outs by 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 new footer
Delete a footer
Update a footer
Get image list
Get an image
Add an image
Replace 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 view report
Get a media timeline report
Get form report
Get page report
Get spam complaint list
Get hard bounce list
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 contents
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