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

SendGrid: Schedule a reminder and cancel it by batch ID

See more SendGrid Examples

Schedule a reminder one hour from now. Save its batch ID when it is allocated. If the appointment is canceled, use that saved ID in the cancellation branch. Mail Send accepts a Unix timestamp up to 72 hours ahead; cancel at least 10 minutes before the send time. Cancellation applies to the entire batch.

Create a batch ID ยท Cancel a batch

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

    --  On cancellation, set this to the batch ID saved with the original appointment.
    --  This branch does not create a new batch or send another reminder.
    DECLARE @batchToCancel nvarchar(4000)
    SELECT @batchToCancel = ''
    IF @batchToCancel <> ''
      BEGIN
        DECLARE @cancellation int
        EXEC @hr = sp_OACreate 'Chilkat.JsonObject', @cancellation OUT

        EXEC sp_OAMethod @cancellation, 'UpdateString', @success OUT, 'batch_id', @batchToCancel
        EXEC sp_OAMethod @cancellation, 'UpdateString', @success OUT, 'status', 'cancel'
        EXEC sp_OAMethod @http, 'HttpJson', @success OUT, 'POST', 'https://api.sendgrid.com/v3/user/scheduled_sends', @cancellation, '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 @cancellation
            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 @cancellation
            RETURN
          END

        PRINT 'Batch cancellation accepted.'
        EXEC @hr = sp_OADestroy @http
        EXEC @hr = sp_OADestroy @resp
        EXEC @hr = sp_OADestroy @cancellation
        RETURN
      END

    EXEC sp_OAMethod @http, 'HttpNoBody', @success OUT, 'POST', 'https://api.sendgrid.com/v3/mail/batch', @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 @cancellation
        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 @cancellation
        RETURN
      END

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

    EXEC sp_OAGetProperty @resp, 'BodyStr', @sTmp0 OUT
    EXEC sp_OAMethod @batch, '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 @cancellation
        EXEC @hr = sp_OADestroy @batch
        RETURN
      END
    DECLARE @batchId nvarchar(4000)
    EXEC sp_OAMethod @batch, 'StringOf', @batchId OUT, 'batch_id'
    EXEC sp_OAMethod @batch, 'HasMember', @iTmp0 OUT, 'batch_id'
    IF @iTmp0 <> 1
      BEGIN

        PRINT 'Missing batch_id in response.'
        EXEC @hr = sp_OADestroy @http
        EXEC @hr = sp_OADestroy @resp
        EXEC @hr = sp_OADestroy @cancellation
        EXEC @hr = sp_OADestroy @batch
        RETURN
      END

    --  Allocate one batch per independently cancelable appointment.

    PRINT 'Save this batch ID with the appointment: ' + @batchId
    DECLARE @sendTime int
    EXEC @hr = sp_OACreate 'Chilkat.CkDateTime', @sendTime OUT

    EXEC sp_OAMethod @sendTime, 'SetFromCurrentSystemTime', @success OUT
    EXEC sp_OAMethod @sendTime, 'AddSeconds', @success OUT, 3600
    DECLARE @message int
    EXEC @hr = sp_OACreate 'Chilkat.JsonObject', @message OUT

    EXEC sp_OAMethod @message, 'UpdateString', @success OUT, 'batch_id', @batchId
    EXEC sp_OAMethod @sendTime, 'GetAsUnixTime', @iTmp0 OUT, 0
    EXEC sp_OAMethod @message, 'UpdateInt', @success OUT, 'send_at', @iTmp0
    EXEC sp_OAMethod @message, 'UpdateString', @success OUT, 'from.email', 'sender@example.com'
    EXEC sp_OAMethod @message, 'UpdateString', @success OUT, 'personalizations[0].to[0].email', 'recipient@example.com'
    EXEC sp_OAMethod @message, 'UpdateString', @success OUT, 'subject', 'Appointment reminder'
    EXEC sp_OAMethod @message, 'UpdateString', @success OUT, 'content[0].type', 'text/plain'
    EXEC sp_OAMethod @message, 'UpdateString', @success OUT, 'content[0].value', 'Your appointment is tomorrow at 9:30 AM Central.'

    EXEC sp_OAMethod @http, 'HttpJson', @success OUT, 'POST', 'https://api.sendgrid.com/v3/mail/send', @message, '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 @cancellation
        EXEC @hr = sp_OADestroy @batch
        EXEC @hr = sp_OADestroy @sendTime
        EXEC @hr = sp_OADestroy @message
        RETURN
      END
    EXEC sp_OAGetProperty @resp, 'StatusCode', @iTmp0 OUT
    IF @iTmp0 <> 202
      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 @cancellation
        EXEC @hr = sp_OADestroy @batch
        EXEC @hr = sp_OADestroy @sendTime
        EXEC @hr = sp_OADestroy @message
        RETURN
      END

    EXEC sp_OAMethod @sendTime, 'GetAsTimestamp', @sTmp0 OUT, 0
    PRINT 'Reminder scheduled for ' + @sTmp0

    EXEC @hr = sp_OADestroy @http
    EXEC @hr = sp_OADestroy @resp
    EXEC @hr = sp_OADestroy @cancellation
    EXEC @hr = sp_OADestroy @batch
    EXEC @hr = sp_OADestroy @sendTime
    EXEC @hr = sp_OADestroy @message


END
GO