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

SQL Server
-- Important: See this note about string length limitations for strings returned by sp_OAMethod calls.
--
CREATE PROCEDURE ChilkatSample
AS
BEGIN
    DECLARE @hr int
    DECLARE @iTmp0 int
    DECLARE @sTmp0 nvarchar(4000)
    DECLARE @success int
    SELECT @success = 0

    --  Assumes Chilkat is unlocked. See Global Unlock Sample.
    SELECT @success = 0
    DECLARE @http int
    EXEC @hr = sp_OACreate 'Chilkat.Http', @http OUT
    IF @hr <> 0
    BEGIN
        PRINT 'Failed to create ActiveX component'
        RETURN
    END

    EXEC sp_OASetProperty @http, 'RequireSslCertVerify', 1
    --  Supply your API key from protected configuration; AuthToken adds the Bearer prefix.
    EXEC sp_OASetProperty @http, 'AuthToken', 'SENDGRID_API_KEY'
    DECLARE @resp int
    EXEC @hr = sp_OACreate 'Chilkat.HttpResponse', @resp OUT

    --  Take the address from the authenticated account and the group ID from configuration.
    DECLARE @address nvarchar(4000)
    SELECT @address = 'reader@example.com'
    EXEC sp_OAMethod @http, 'SetUrlVar', @success OUT, 'group', '12345'

    EXEC sp_OAMethod @http, 'HttpNoBody', @success OUT, 'GET', 'https://api.sendgrid.com/v3/asm/groups/{$group}', @resp
    IF @success <> 1
      BEGIN
        EXEC sp_OAGetProperty @resp, 'StatusCode', @iTmp0 OUT
        IF @iTmp0 = 0
          BEGIN
            EXEC sp_OAGetProperty @http, 'LastErrorText', @sTmp0 OUT
            PRINT @sTmp0
          END
        ELSE
          BEGIN

            EXEC sp_OAGetProperty @resp, 'StatusCode', @iTmp0 OUT

            EXEC sp_OAGetProperty @resp, 'BodyStr', @sTmp0 OUT
            PRINT 'HTTP ' + @iTmp0 + ': ' + @sTmp0
          END
        EXEC @hr = sp_OADestroy @http
        EXEC @hr = sp_OADestroy @resp
        RETURN
      END
    EXEC sp_OAGetProperty @resp, 'StatusCode', @iTmp0 OUT
    IF @iTmp0 <> 200
      BEGIN

        EXEC sp_OAGetProperty @resp, 'StatusCode', @iTmp0 OUT

        EXEC sp_OAGetProperty @resp, 'BodyStr', @sTmp0 OUT
        PRINT 'HTTP ' + @iTmp0 + ': ' + @sTmp0
        EXEC @hr = sp_OADestroy @http
        EXEC @hr = sp_OADestroy @resp
        RETURN
      END

    DECLARE @groupInfo int
    EXEC @hr = sp_OACreate 'Chilkat.JsonObject', @groupInfo OUT

    EXEC sp_OAGetProperty @resp, 'BodyStr', @sTmp0 OUT
    EXEC sp_OAMethod @groupInfo, 'Load', @success OUT, @sTmp0
    IF @success <> 1
      BEGIN

        PRINT 'Unexpected response: expected JSON.'
        EXEC @hr = sp_OADestroy @http
        EXEC @hr = sp_OADestroy @resp
        EXEC @hr = sp_OADestroy @groupInfo
        RETURN
      END
    EXEC sp_OAMethod @groupInfo, 'StringOfEquals', @iTmp0 OUT, 'name', 'Product updates', 1
    IF @iTmp0 <> 1
      BEGIN

        PRINT 'Unexpected unsubscribe group; no preference was changed.'
        EXEC @hr = sp_OADestroy @http
        EXEC @hr = sp_OADestroy @resp
        EXEC @hr = sp_OADestroy @groupInfo
        RETURN
      END
    DECLARE @addresses int
    EXEC @hr = sp_OACreate 'Chilkat.JsonObject', @addresses OUT

    EXEC sp_OAMethod @addresses, 'UpdateString', @success OUT, 'recipient_emails[0]', @address

    EXEC sp_OAMethod @http, 'HttpJson', @success OUT, 'POST', 'https://api.sendgrid.com/v3/asm/groups/{$group}/suppressions', @addresses, 'application/json', @resp
    IF @success <> 1
      BEGIN
        EXEC sp_OAGetProperty @resp, 'StatusCode', @iTmp0 OUT
        IF @iTmp0 = 0
          BEGIN
            EXEC sp_OAGetProperty @http, 'LastErrorText', @sTmp0 OUT
            PRINT @sTmp0
          END
        ELSE
          BEGIN

            EXEC sp_OAGetProperty @resp, 'StatusCode', @iTmp0 OUT

            EXEC sp_OAGetProperty @resp, 'BodyStr', @sTmp0 OUT
            PRINT 'HTTP ' + @iTmp0 + ': ' + @sTmp0
          END
        EXEC @hr = sp_OADestroy @http
        EXEC @hr = sp_OADestroy @resp
        EXEC @hr = sp_OADestroy @groupInfo
        EXEC @hr = sp_OADestroy @addresses
        RETURN
      END
    EXEC sp_OAGetProperty @resp, 'StatusCode', @iTmp0 OUT
    IF @iTmp0 <> 201
      BEGIN

        EXEC sp_OAGetProperty @resp, 'StatusCode', @iTmp0 OUT

        EXEC sp_OAGetProperty @resp, 'BodyStr', @sTmp0 OUT
        PRINT 'HTTP ' + @iTmp0 + ': ' + @sTmp0
        EXEC @hr = sp_OADestroy @http
        EXEC @hr = sp_OADestroy @resp
        EXEC @hr = sp_OADestroy @groupInfo
        EXEC @hr = sp_OADestroy @addresses
        RETURN
      END

    EXEC sp_OAMethod @http, 'HttpJson', @success OUT, 'POST', 'https://api.sendgrid.com/v3/asm/groups/{$group}/suppressions/search', @addresses, 'application/json', @resp
    IF @success <> 1
      BEGIN
        EXEC sp_OAGetProperty @resp, 'StatusCode', @iTmp0 OUT
        IF @iTmp0 = 0
          BEGIN
            EXEC sp_OAGetProperty @http, 'LastErrorText', @sTmp0 OUT
            PRINT @sTmp0
          END
        ELSE
          BEGIN

            EXEC sp_OAGetProperty @resp, 'StatusCode', @iTmp0 OUT

            EXEC sp_OAGetProperty @resp, 'BodyStr', @sTmp0 OUT
            PRINT 'HTTP ' + @iTmp0 + ': ' + @sTmp0
          END
        EXEC @hr = sp_OADestroy @http
        EXEC @hr = sp_OADestroy @resp
        EXEC @hr = sp_OADestroy @groupInfo
        EXEC @hr = sp_OADestroy @addresses
        RETURN
      END
    EXEC sp_OAGetProperty @resp, 'StatusCode', @iTmp0 OUT
    IF @iTmp0 <> 200
      BEGIN

        EXEC sp_OAGetProperty @resp, 'StatusCode', @iTmp0 OUT

        EXEC sp_OAGetProperty @resp, 'BodyStr', @sTmp0 OUT
        PRINT 'HTTP ' + @iTmp0 + ': ' + @sTmp0
        EXEC @hr = sp_OADestroy @http
        EXEC @hr = sp_OADestroy @resp
        EXEC @hr = sp_OADestroy @groupInfo
        EXEC @hr = sp_OADestroy @addresses
        RETURN
      END

    DECLARE @matches int
    EXEC @hr = sp_OACreate 'Chilkat.JsonArray', @matches OUT

    EXEC sp_OAGetProperty @resp, 'BodyStr', @sTmp0 OUT
    EXEC sp_OAMethod @matches, 'Load', @success OUT, @sTmp0
    IF @success <> 1
      BEGIN

        PRINT 'Unexpected response: expected JSON.'
        EXEC @hr = sp_OADestroy @http
        EXEC @hr = sp_OADestroy @resp
        EXEC @hr = sp_OADestroy @groupInfo
        EXEC @hr = sp_OADestroy @addresses
        EXEC @hr = sp_OADestroy @matches
        RETURN
      END
    EXEC sp_OAGetProperty @matches, 'Size', @iTmp0 OUT
    IF @iTmp0 = 1
      BEGIN

        EXEC sp_OAMethod @matches, 'StringAt', @sTmp0 OUT, 0
        PRINT 'Confirmed opt-out: ' + @sTmp0
      END
    ELSE
      BEGIN

        PRINT 'Opt-out not confirmed. Recheck this group.'
      END

    EXEC @hr = sp_OADestroy @http
    EXEC @hr = sp_OADestroy @resp
    EXEC @hr = sp_OADestroy @groupInfo
    EXEC @hr = sp_OADestroy @addresses
    EXEC @hr = sp_OADestroy @matches


END
GO