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.
Authorization
apiKey Your 48 character API key, sent as is (a Bearer prefix is tolerated). Create it at https://v3.emelia.io/settings/api.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/lists/list" \ -H "Authorization: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "name": "Acme prospects Q4" }'{ "success": true, "listId": "66f1c0ffee5a7d3b2c4e8a10", "name": "Acme prospects Q4"}