CREATE

Create Contact List

Creates a new contact list in your account.

Endpoint

PUT v5/contactlist

Requires authentication

Path Parameters

This endpoint does not include path parameters.

None

Query Parameters

list_name
string
required
The display name for the new contact list.

Response

Returns the result of the creation request and the newly created contact list object.

result_ok
boolean
Whether the request succeeded.
data
object
The newly created contact list object. See Get Contact List for the full list of response fields.

Examples

Request (cURL)
curl -X PUT "https://api.alchemer.com/v5/contactlist?api_token=YOUR_API_TOKEN&api_token_secret=YOUR_API_TOKEN_SECRET&list_name=New+Contact+List"
Response
{
  "result_ok": true,
  "data": {
    "id": 1,
    "list_name": "New Contact List",
    "date_modified": "2012-10-23 10:46:09",
    "date_created": "2012-10-23 10:01:00",
    "user_id_created": 183830,
    "user_id_modified": 0
  }
}