Create a contacts group.md

Create a contacts group

Creates an empty group of contacts given a name and a description.

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/group

Body Fields

Parameter	Type	Description	Required	Default
name	String	The name of the group	Yes	-
description	String	The description of the group	Yes	-

Returns

Code	Description
201	An empty string, and the HTTP Location header containing the path to the newly created group
400	If the group name is invalid, or other errors, with a code error
401	[Unauthorized] User_key, Token or Session_key are invalid or not provided
404	[Not found] If the requesting user does not exist.