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

DataFlex
Use ChilkatAx-win32.pkg

Procedure Test
    Boolean iSuccess
    Handle hoHttp
    Variant vResp
    Handle hoResp
    String sAddress
    Handle hoGroupInfo
    Variant vAddresses
    Handle hoAddresses
    Handle hoMatches
    String sTemp1
    Integer iTemp1
    Boolean bTemp1

    Move False To iSuccess

    //  Assumes Chilkat is unlocked. See Global Unlock Sample.
    Move False To iSuccess
    Get Create (RefClass(cComChilkatHttp)) To hoHttp
    If (Not(IsComObjectCreated(hoHttp))) Begin
        Send CreateComObject of hoHttp
    End
    Set ComRequireSslCertVerify Of hoHttp To True
    //  Supply your API key from protected configuration; AuthToken adds the Bearer prefix.
    Set ComAuthToken Of hoHttp To "SENDGRID_API_KEY"
    Get Create (RefClass(cComChilkatHttpResponse)) To hoResp
    If (Not(IsComObjectCreated(hoResp))) Begin
        Send CreateComObject of hoResp
    End

    //  Take the address from the authenticated account and the group ID from configuration.
    Move "reader@example.com" To sAddress
    Get ComSetUrlVar Of hoHttp "group" "12345" To iSuccess

    Get pvComObject of hoResp to vResp
    Get ComHttpNoBody Of hoHttp "GET" "https://api.sendgrid.com/v3/asm/groups/{$group}" vResp To iSuccess
    If (iSuccess <> True) Begin
        Get ComStatusCode Of hoResp To iTemp1
        If (iTemp1 = 0) Begin
            Get ComLastErrorText Of hoHttp To sTemp1
            Showln sTemp1
        End
        Else Begin
            Get ComStatusCode Of hoResp To iTemp1
            Get ComBodyStr Of hoResp To sTemp1
            Showln "HTTP " iTemp1 ": " sTemp1
        End

        Procedure_Return
    End

    Get ComStatusCode Of hoResp To iTemp1
    If (iTemp1 <> 200) Begin
        Get ComStatusCode Of hoResp To iTemp1
        Get ComBodyStr Of hoResp To sTemp1
        Showln "HTTP " iTemp1 ": " sTemp1
        Procedure_Return
    End

    Get Create (RefClass(cComChilkatJsonObject)) To hoGroupInfo
    If (Not(IsComObjectCreated(hoGroupInfo))) Begin
        Send CreateComObject of hoGroupInfo
    End
    Get ComBodyStr Of hoResp To sTemp1
    Get ComLoad Of hoGroupInfo sTemp1 To iSuccess
    If (iSuccess <> True) Begin
        Showln "Unexpected response: expected JSON."
        Procedure_Return
    End

    Get ComStringOfEquals Of hoGroupInfo "name" "Product updates" True To bTemp1
    If (bTemp1 <> True) Begin
        Showln "Unexpected unsubscribe group; no preference was changed."
        Procedure_Return
    End

    Get Create (RefClass(cComChilkatJsonObject)) To hoAddresses
    If (Not(IsComObjectCreated(hoAddresses))) Begin
        Send CreateComObject of hoAddresses
    End
    Get ComUpdateString Of hoAddresses "recipient_emails[0]" sAddress To iSuccess

    Get pvComObject of hoAddresses to vAddresses
    Get pvComObject of hoResp to vResp
    Get ComHttpJson Of hoHttp "POST" "https://api.sendgrid.com/v3/asm/groups/{$group}/suppressions" vAddresses "application/json" vResp To iSuccess
    If (iSuccess <> True) Begin
        Get ComStatusCode Of hoResp To iTemp1
        If (iTemp1 = 0) Begin
            Get ComLastErrorText Of hoHttp To sTemp1
            Showln sTemp1
        End
        Else Begin
            Get ComStatusCode Of hoResp To iTemp1
            Get ComBodyStr Of hoResp To sTemp1
            Showln "HTTP " iTemp1 ": " sTemp1
        End

        Procedure_Return
    End

    Get ComStatusCode Of hoResp To iTemp1
    If (iTemp1 <> 201) Begin
        Get ComStatusCode Of hoResp To iTemp1
        Get ComBodyStr Of hoResp To sTemp1
        Showln "HTTP " iTemp1 ": " sTemp1
        Procedure_Return
    End

    Get pvComObject of hoAddresses to vAddresses
    Get pvComObject of hoResp to vResp
    Get ComHttpJson Of hoHttp "POST" "https://api.sendgrid.com/v3/asm/groups/{$group}/suppressions/search" vAddresses "application/json" vResp To iSuccess
    If (iSuccess <> True) Begin
        Get ComStatusCode Of hoResp To iTemp1
        If (iTemp1 = 0) Begin
            Get ComLastErrorText Of hoHttp To sTemp1
            Showln sTemp1
        End
        Else Begin
            Get ComStatusCode Of hoResp To iTemp1
            Get ComBodyStr Of hoResp To sTemp1
            Showln "HTTP " iTemp1 ": " sTemp1
        End

        Procedure_Return
    End

    Get ComStatusCode Of hoResp To iTemp1
    If (iTemp1 <> 200) Begin
        Get ComStatusCode Of hoResp To iTemp1
        Get ComBodyStr Of hoResp To sTemp1
        Showln "HTTP " iTemp1 ": " sTemp1
        Procedure_Return
    End

    Get Create (RefClass(cComChilkatJsonArray)) To hoMatches
    If (Not(IsComObjectCreated(hoMatches))) Begin
        Send CreateComObject of hoMatches
    End
    Get ComBodyStr Of hoResp To sTemp1
    Get ComLoad Of hoMatches sTemp1 To iSuccess
    If (iSuccess <> True) Begin
        Showln "Unexpected response: expected JSON."
        Procedure_Return
    End

    Get ComSize Of hoMatches To iTemp1
    If (iTemp1 = 1) Begin
        Get ComStringAt Of hoMatches 0 To sTemp1
        Showln "Confirmed opt-out: " sTemp1
    End
    Else Begin
        Showln "Opt-out not confirmed. Recheck this group."
    End



End_Procedure