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
Parameter | Data Type | Description |
accountID* | Integer | accountID - The unique Zoho Account Identifier under which a new folder should be created |
* - Mandatory parameters
Request Body (JSON Object)
Parameter | Data Type | Allowed Values | Description |
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) | Integer | The 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) | String | Hex 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"
}
}