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

SendGrid: Save and verify a topic opt-out

See more SendGrid Examples

Use this when a signed-in reader turns off Product updates. Look up the configured group before submitting: SendGrid warns that a nonexistent or deleted group can cause a global suppression instead. Keep the group active while processing preferences. Deleting a marketing contact is not a substitute for recording an opt-out.

Add group suppressions ยท Check specific addresses

Chilkat PHP ActiveX Downloads

PHP ActiveX
<?php

$success = 0;

//  Assumes Chilkat is unlocked. See Global Unlock Sample.
$success = 0;
$http = new COM("Chilkat.Http");
$http->RequireSslCertVerify = 1;
//  Supply your API key from protected configuration; AuthToken adds the Bearer prefix.
$http->AuthToken = 'SENDGRID_API_KEY';
$resp = new COM("Chilkat.HttpResponse");

//  Take the address from the authenticated account and the group ID from configuration.
$address = 'reader@example.com';
$http->SetUrlVar('group','12345');

$success = $http->HttpNoBody('GET','https://api.sendgrid.com/v3/asm/groups/{$group}',$resp);
if ($success != 1) {
    if ($resp->StatusCode == 0) {
        print $http->LastErrorText . "\n";
    }
    else {
        print 'HTTP ' . $resp->StatusCode . ': ' . $resp->BodyStr . "\n";
    }

    exit;
}

if ($resp->StatusCode != 200) {
    print 'HTTP ' . $resp->StatusCode . ': ' . $resp->BodyStr . "\n";
    exit;
}

$groupInfo = new COM("Chilkat.JsonObject");
$success = $groupInfo->Load($resp->BodyStr);
if ($success != 1) {
    print 'Unexpected response: expected JSON.' . "\n";
    exit;
}

if ($groupInfo->StringOfEquals('name','Product updates',1) != 1) {
    print 'Unexpected unsubscribe group; no preference was changed.' . "\n";
    exit;
}

$addresses = new COM("Chilkat.JsonObject");
$addresses->UpdateString('recipient_emails[0]',$address);

$success = $http->HttpJson('POST','https://api.sendgrid.com/v3/asm/groups/{$group}/suppressions',$addresses,'application/json',$resp);
if ($success != 1) {
    if ($resp->StatusCode == 0) {
        print $http->LastErrorText . "\n";
    }
    else {
        print 'HTTP ' . $resp->StatusCode . ': ' . $resp->BodyStr . "\n";
    }

    exit;
}

if ($resp->StatusCode != 201) {
    print 'HTTP ' . $resp->StatusCode . ': ' . $resp->BodyStr . "\n";
    exit;
}

$success = $http->HttpJson('POST','https://api.sendgrid.com/v3/asm/groups/{$group}/suppressions/search',$addresses,'application/json',$resp);
if ($success != 1) {
    if ($resp->StatusCode == 0) {
        print $http->LastErrorText . "\n";
    }
    else {
        print 'HTTP ' . $resp->StatusCode . ': ' . $resp->BodyStr . "\n";
    }

    exit;
}

if ($resp->StatusCode != 200) {
    print 'HTTP ' . $resp->StatusCode . ': ' . $resp->BodyStr . "\n";
    exit;
}

$matches = new COM("Chilkat.JsonArray");
$success = $matches->Load($resp->BodyStr);
if ($success != 1) {
    print 'Unexpected response: expected JSON.' . "\n";
    exit;
}

if ($matches->Size == 1) {
    print 'Confirmed opt-out: ' . $matches->stringAt(0) . "\n";
}
else {
    print 'Opt-out not confirmed. Recheck this group.' . "\n";
}


?>