acton create list

Create an Act-On List

Version: 17.07

Supported Since: 17.07

Create Act-On List connector operation provides the ability to create a specified list with or without inserting records. Records are retrieved from the message payload which is received by the connector operation.

Parameters

* marked fields are mandatory

List Name *

Basic

The list name to display in the UI. This can be specified as a constant value or as a combination of placeholder expressions such as @{message.headers.<name>}, @{message.properties.<name>}, @{message.id}, @{mc.id}, @{mc.properties.<name>}, @{variable.<name>}.

Folder Name

Basic

Name of folder that contains the list. This can be specified as a constant value or as a combination of placeholder expressions such as @{message.headers.<name>}, @{message.properties.<name>}, @{message.id}, @{mc.id}, @{mc.properties.<name>}, @{variable.<name>}.

Enable Headings

Basic

If specified as true, cells on the first row of the file are considered as headings.

Field Separator

Basic

Character used around fields; valid values: COMMA, TAB, SEMI.

Upload Specification *

Basic

A JSON object describing the structure of the payload being uploaded when creating a new list

You can learn more about the upload specification here.

Quote Character *

Basic

The type of quotes used around field names; valid values: NONE, SINGLE_QUOTE, DOUBLE_QUOTE.

Response

If this operation was invoked successfully, it will provide a response message with a JSON payload of the following format.

{
    "status": "success",
    "message": "Upload completed",
    "jobId": "8167376"
}

If you do not include a payload of records in this operation, an empty list is created and the list ID is returned:

{
    "listId": "l-0c87",
    "status": "success",
    "message": "List created"
}
In this topic
In this topic
Contact Us