Sample code for 30+ languages & platforms
CkPerl Requires Chilkat v11.0.0+

Create a user label in Gmail

See more GMail REST API Examples

Create a label with a chosen display name. Gmail returns the ID used to apply the label to messages. If a user label with that name already exists, look up its ID instead of creating a duplicate. System label names are reserved.

Authorize the application with https://www.googleapis.com/auth/gmail.labels. The example reads the access token from gmail-token.json in a private working directory. Authorize a desktop application.

Google documentation

Chilkat CkPerl Downloads

CkPerl
use chilkat();

$success = 0;

#  Assumes Chilkat is unlocked. See Global Unlock Sample.

$token = chilkat::CkJsonObject->new();
$success = $token->LoadFile("gmail-token.json");
if ($success != 1) {
    print "Could not read gmail-token.json from the private working directory." . "\r\n";
    exit;
}

if (($token->JsonTypeOf("access_token") != 1) or ($token->StringOfEquals("access_token","",1) == 1)) {
    print "An OAuth access token is required." . "\r\n";
    exit;
}

$http = chilkat::CkHttp->new();
$http->put_RequireSslCertVerify(1);
$http->put_AuthToken($token->stringOf("access_token"));
$resp = chilkat::CkHttpResponse->new();
$reply = chilkat::CkJsonObject->new();
$request = chilkat::CkJsonObject->new();
$request->UpdateString("name","To review");
$request->UpdateString("labelListVisibility","labelShow");
$request->UpdateString("messageListVisibility","show");
$success = $http->HttpJson("POST","https://gmail.googleapis.com/gmail/v1/users/me/labels",$request,"application/json",$resp);
if ($resp->get_StatusCode() == 0) {
    print "Gmail did not return an HTTP response." . "\r\n";
    exit;
}

if (($success != 1) or ($resp->get_StatusCode() < 200) or ($resp->get_StatusCode() >= 300)) {
    print "Gmail HTTP " . $resp->get_StatusCode() . "\r\n";
    $success = $reply->Load($resp->bodyStr());
    if ($success == 1) {
        print $reply->stringOf("error.message") . "\r\n";
    }

    exit;
}

$success = $reply->Load($resp->bodyStr());
if ($success != 1) {
    print "Expected a Gmail JSON response." . "\r\n";
    exit;
}

if (($reply->JsonTypeOf("id") != 1) or ($reply->StringOfEquals("id","",1) == 1)) {
    print "Expected id in the response." . "\r\n";
    exit;
}

print "Created label: " . $reply->stringOf("name") . "\r\n";
print "Label ID: " . $reply->stringOf("id") . "\r\n";