Create a new list.md

Create a new list

Create a new sending list.

Remember to provide the authentication HTTP headers as described in the Authenticate using a session key and the Authenticate using a user token sections.

All the query string parameters in URL must be UTF-8 URL Encoded.

---

HTTP Headers

user_key / Session_key

HTTP Method

POST

HTTP Request

https://app.gateway.smsend.it/API/v1.0/REST/list

Body Fields

Parameter	Type	Description	Required	Default
title	String	The list name	Yes	-
id_language	String (e.g. “ita”)	The list default language	Yes	-
email_sender	a valid email	The sender’s email address	Yes	-
reply_to	a valid email	The email to be used for the ‘reply_to’ email field	Yes	-
company_name	String	The company name	Yes	-
company_address	String	The company address	Yes	-
company_url	String	The company website URL	Yes	-
company_phone	String	The company phone number	Yes	-
company_fax	String	The company FAX number	Yes	-

Returns

Code	Description
201	List created, The HTTP location header that points to the created list
400	Other errors, details are in the body
401	[Unauthorized] User_key, Token or Session_key are invalid or not provided
404	[Not found] The User_key was not found