Create a list

POST  https://:account.api-us1.com/api/3/lists

• JSON

{
	"list": {
		"name": "Name of List",
		"stringid": "My string id"
	}
}

 

200 OK

{
    "list": {
        "name": "Name of List",
        "stringid": "My string id",
        "cdate": "2018-09-28T19:06:23-05:00",
        "udate": "2018-09-28T19:06:23-05:00",
        "links": {
            "contactGoalLists": "https://:account.api-us1.com/api/:version/lists/6/contactGoalLists",
            "user": "https://:account.api-us1.com/api/:version/lists/6/user",
            "addressLists": "https://:account.api-us1.com/api/:version/lists/6/addressLists"
        },
        "id": "6"
    }
}

403 Forbidden

{
    "errors": [
        {
            "status": 403,
            "title": "Forbidden",
            "detail": "You do not have permission to create lists."
        }
    ]
}

BODY PARAMS

list

object

 

list.name

string                                  Name of the list to create

 

list.stringid

string                                  String ID of the new list