Create contact list

Create a new contact list.

Method

POST

Path

/lists

Body parameters

Name	Value	Data type	Required?
name	Contact list name	String	Yes

Response

HTTP status codes

Code	Remarks
200	Request was successful.
400	Validation error or request body was incorrectly formatted.
401	Authentication failed. Check `apikey` header.
404	Requested API endpoint not found.
429	The rate limit has been reached.
500-511	There was a problem processing the request on our server. Try again later.

Response object

Name	Value	Remarks
status	`success` or `error`	-
errors	Array of object `{ msg: [error detail] }`	Only present when status is `error`.
data	Object `{ id: [new contact list id]}`	Only present when status is `success`

Code sample

curl --location --request POST 'https://api.sociocs.com/lists' \
--header 'apikey: your_api_key' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "My Contact List"
}'