Lists

Create a list

Creates an empty list with source API and status mapped, immediately ready to receive contacts through POST /lists/list/{listId}/contacts or the batch route. List names do not need to be unique: calling this twice creates two lists, so store the returned listId.

To make the contacts of the list enter a campaign, attach the list to the campaign (in the app or through the Campaigns API). Contacts added afterwards flow into the campaigns that use the list.

Do not send source: the value Manual is reserved to the web app and starts the list with most columns hidden, which removes their fields from GET /lists/list/{listId}/rows until contacts fill them.

post/lists/list

Request

  • Base URL: https://api.emelia.io
  • URL: https://api.emelia.io/lists/list
  • Auth: API key in header Authorization

Request body

namestring required

List name, trimmed. Must not be empty.

Response

List created.

successtrue required
listIdstring required
namestring required

Changes

No recorded changes to this operation across all 1 revision of this API.