Get a Specific Label

Purpose 

This API is used to retrieve details of a specific label associated with the label ID.

OAuth Scope

Use the scope

MailApps.tags.ALL (or) MailApps.tags.READ

ALL - Full access to labels

READ - Fetch all labels

To generate Authtoken, refer here.

Request URL

Method: GET

https://mail360.zoho.com/api/accounts/{account_key}/labels/{labelid}

Path Parameters

  • account_key* string
    • This is a unique key used to identify the mailbox. It is generated during account addition.
    • This parameter can be fetched from Get all accounts API.
  • labelid* long
    • This is a unique key used to identify the specific label. It is generated during label creation.
    • This parameter can be fetched from Get all labels API.

Sample Request

Copiedcurl "https://mail360.zoho.com/api/accounts/x7**s/labels/27684000000021003" \
-X GET \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization:Zoho-oauthtoken 802432**09d8c98b4ac3" \

Sample Response

Copied{
    "status": {
        "code": 200,
        "description": "success"
    },
    "data": {
        "labelId": "27684000000021003",
        "displayName": "L1",
        "color": "#FFD700",
        "sequence": 1
    }
}