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

DataFlex
Use ChilkatAx-win32.pkg

Procedure Test
    Boolean iSuccess
    Handle hoHttp
    Variant vResp
    Handle hoResp
    String sBatchToCancel
    Variant vCancellation
    Handle hoCancellation
    Handle hoBatch
    String sBatchId
    Handle hoSendTime
    Variant vMessage
    Handle hoMessage
    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

    //  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.
    Move "" To sBatchToCancel
    If (sBatchToCancel <> "") Begin
        Get Create (RefClass(cComChilkatJsonObject)) To hoCancellation
        If (Not(IsComObjectCreated(hoCancellation))) Begin
            Send CreateComObject of hoCancellation
        End
        Get ComUpdateString Of hoCancellation "batch_id" sBatchToCancel To iSuccess
        Get ComUpdateString Of hoCancellation "status" "cancel" To iSuccess
        Get pvComObject of hoCancellation to vCancellation
        Get pvComObject of hoResp to vResp
        Get ComHttpJson Of hoHttp "POST" "https://api.sendgrid.com/v3/user/scheduled_sends" vCancellation "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

        Showln "Batch cancellation accepted."
        Procedure_Return
    End

    Get pvComObject of hoResp to vResp
    Get ComHttpNoBody Of hoHttp "POST" "https://api.sendgrid.com/v3/mail/batch" 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 Create (RefClass(cComChilkatJsonObject)) To hoBatch
    If (Not(IsComObjectCreated(hoBatch))) Begin
        Send CreateComObject of hoBatch
    End
    Get ComBodyStr Of hoResp To sTemp1
    Get ComLoad Of hoBatch sTemp1 To iSuccess
    If (iSuccess <> True) Begin
        Showln "Unexpected response: expected JSON."
        Procedure_Return
    End

    Get ComStringOf Of hoBatch "batch_id" To sBatchId
    Get ComHasMember Of hoBatch "batch_id" To bTemp1
    If (bTemp1 <> True) Begin
        Showln "Missing batch_id in response."
        Procedure_Return
    End

    //  Allocate one batch per independently cancelable appointment.
    Showln "Save this batch ID with the appointment: " sBatchId
    Get Create (RefClass(cComCkDateTime)) To hoSendTime
    If (Not(IsComObjectCreated(hoSendTime))) Begin
        Send CreateComObject of hoSendTime
    End
    Get ComSetFromCurrentSystemTime Of hoSendTime To iSuccess
    Get ComAddSeconds Of hoSendTime 3600 To iSuccess
    Get Create (RefClass(cComChilkatJsonObject)) To hoMessage
    If (Not(IsComObjectCreated(hoMessage))) Begin
        Send CreateComObject of hoMessage
    End
    Get ComUpdateString Of hoMessage "batch_id" sBatchId To iSuccess
    Get ComGetAsUnixTime Of hoSendTime False To iTemp1
    Get ComUpdateInt Of hoMessage "send_at" iTemp1 To iSuccess
    Get ComUpdateString Of hoMessage "from.email" "sender@example.com" To iSuccess
    Get ComUpdateString Of hoMessage "personalizations[0].to[0].email" "recipient@example.com" To iSuccess
    Get ComUpdateString Of hoMessage "subject" "Appointment reminder" To iSuccess
    Get ComUpdateString Of hoMessage "content[0].type" "text/plain" To iSuccess
    Get ComUpdateString Of hoMessage "content[0].value" "Your appointment is tomorrow at 9:30 AM Central." To iSuccess

    Get pvComObject of hoMessage to vMessage
    Get pvComObject of hoResp to vResp
    Get ComHttpJson Of hoHttp "POST" "https://api.sendgrid.com/v3/mail/send" vMessage "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 <> 202) Begin
        Get ComStatusCode Of hoResp To iTemp1
        Get ComBodyStr Of hoResp To sTemp1
        Showln "HTTP " iTemp1 ": " sTemp1
        Procedure_Return
    End

    Get ComGetAsTimestamp Of hoSendTime False To sTemp1
    Showln "Reminder scheduled for " sTemp1


End_Procedure