POST - Create a new Label in the account

 Purpose

The API creates a new Label in the specified account. 

 Request URL 

 https://mail.zoho.com/api/accounts/<accountId>/labels

 Request Parameters

ParameterData TypeDescription
accountID*IntegeraccountID - The unique Zoho Account Identifier under which a new folder should be created

* - Mandatory parameters

  Request Body (JSON Object)

ParameterData TypeAllowed ValuesDescription

displayName(string)*

 String A Label name with Alphabets/ Letters without any special character

 Specify the unique name of the Label, which should be created in the particular account. 

sequence(int)IntegerThe order sequence of the Label, which should be created and placed.

Provide the order or the sequnce number of the Label, where the new Label should be created. 

color(String)StringHex value of the color, which should be associated with the Label.Provide the hex value of the color, which you want to associate with the created Label. 

* - Mandatory parameters

Response Codes

Please refer Response Codes.

Sample Request


				{
    "color": "#FFFFFF",
    "displayName": "Campaigns"
}			

Sample Response


				{
  "status" : {
    "code" : 201,
    "description" : "Created"
  },
  "data" : {
    "sequence" : 10,
    "labelId" : "5164940000000618001",
    "color" : "#FFFFFF",
    "tagId" : "5164940000000618001",
    "displayName" : "Campaigns",
    "URI" : "https://mail.zoho.com/api/accounts/5164940000000008001/labels/5164940000000618001"
  }
}