Sample code for 30+ languages & platforms
CkPython 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 CkPython Downloads

CkPython
import sys
import chilkat

success = False

#  Assumes Chilkat is unlocked. See Global Unlock Sample.
success = False
http = chilkat.CkHttp()
http.put_RequireSslCertVerify(True)
#  Supply your API key from protected configuration; AuthToken adds the Bearer prefix.
http.put_AuthToken("SENDGRID_API_KEY")
resp = chilkat.CkHttpResponse()

#  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 != True):
    if (resp.get_StatusCode() == 0):
        print(http.lastErrorText())
    else:
        print("HTTP " + str(resp.get_StatusCode()) + ": " + resp.bodyStr())

    sys.exit()

if (resp.get_StatusCode() != 200):
    print("HTTP " + str(resp.get_StatusCode()) + ": " + resp.bodyStr())
    sys.exit()

groupInfo = chilkat.CkJsonObject()
success = groupInfo.Load(resp.bodyStr())
if (success != True):
    print("Unexpected response: expected JSON.")
    sys.exit()

if (groupInfo.StringOfEquals("name","Product updates",True) != True):
    print("Unexpected unsubscribe group; no preference was changed.")
    sys.exit()

addresses = chilkat.CkJsonObject()
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 != True):
    if (resp.get_StatusCode() == 0):
        print(http.lastErrorText())
    else:
        print("HTTP " + str(resp.get_StatusCode()) + ": " + resp.bodyStr())

    sys.exit()

if (resp.get_StatusCode() != 201):
    print("HTTP " + str(resp.get_StatusCode()) + ": " + resp.bodyStr())
    sys.exit()

success = http.HttpJson("POST","https://api.sendgrid.com/v3/asm/groups/{$group}/suppressions/search",addresses,"application/json",resp)
if (success != True):
    if (resp.get_StatusCode() == 0):
        print(http.lastErrorText())
    else:
        print("HTTP " + str(resp.get_StatusCode()) + ": " + resp.bodyStr())

    sys.exit()

if (resp.get_StatusCode() != 200):
    print("HTTP " + str(resp.get_StatusCode()) + ": " + resp.bodyStr())
    sys.exit()

matches = chilkat.CkJsonArray()
success = matches.Load(resp.bodyStr())
if (success != True):
    print("Unexpected response: expected JSON.")
    sys.exit()

if (matches.get_Size() == 1):
    print("Confirmed opt-out: " + matches.stringAt(0))
else:
    print("Opt-out not confirmed. Recheck this group.")