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

SendGrid: Create a newsletter draft, then schedule the reviewed draft

See more SendGrid Examples

Prepare a Marketing Campaigns design with a subject, content, and an unsubscribe module. Supply the design and list UUIDs, a verified marketing sender ID, and the unsubscribe group ID. The first run creates only a draft. After reviewing the audience and content, run the scheduling branch with that same ID. Single Sends use an ISO 8601 UTC string, unlike Mail Send’s numeric Unix timestamp.

Create a Single Send · Schedule a Single Send

Chilkat DataFlex Downloads

DataFlex
Use ChilkatAx-win32.pkg

Procedure Test
    Boolean iSuccess
    Handle hoHttp
    Variant vResp
    Handle hoResp
    String sReviewedDraftId
    Variant vDraft
    Handle hoDraft
    Handle hoCreated
    String sDraftId
    Handle hoReleaseTime
    Variant vSchedule
    Handle hoSchedule
    Handle hoScheduled
    String sTemp1
    String sTemp2
    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

    //  Leave this empty to create a draft. To schedule, supply the ID of an already reviewed draft.
    Move "" To sReviewedDraftId
    If (sReviewedDraftId = "") Begin
        Get Create (RefClass(cComChilkatJsonObject)) To hoDraft
        If (Not(IsComObjectCreated(hoDraft))) Begin
            Send CreateComObject of hoDraft
        End
        Get ComUpdateString Of hoDraft "name" "November newsletter" To iSuccess
        Get ComUpdateString Of hoDraft "send_to.list_ids[0]" "YOUR_LIST_UUID" To iSuccess
        Get ComUpdateInt Of hoDraft "email_config.sender_id" 12345 To iSuccess
        Get ComUpdateInt Of hoDraft "email_config.suppression_group_id" 67890 To iSuccess
        Get ComUpdateString Of hoDraft "email_config.design_id" "YOUR_NEWSLETTER_DESIGN_UUID" To iSuccess
        Get pvComObject of hoDraft to vDraft
        Get pvComObject of hoResp to vResp
        Get ComHttpJson Of hoHttp "POST" "https://api.sendgrid.com/v3/marketing/singlesends" vDraft "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 Create (RefClass(cComChilkatJsonObject)) To hoCreated
        If (Not(IsComObjectCreated(hoCreated))) Begin
            Send CreateComObject of hoCreated
        End
        Get ComBodyStr Of hoResp To sTemp1
        Get ComLoad Of hoCreated sTemp1 To iSuccess
        If (iSuccess <> True) Begin
            Showln "Unexpected response: expected JSON."
            Procedure_Return
        End

        Get ComStringOf Of hoCreated "id" To sDraftId
        Get ComHasMember Of hoCreated "id" To bTemp1
        If (bTemp1 <> True) Begin
            Showln "Missing id in response."
            Procedure_Return
        End

        Showln "Draft created: " sDraftId ". Review it in Marketing Campaigns before scheduling."
        Procedure_Return
    End

    //  The example selects tomorrow at the current UTC time. Use your approved send time.
    Get Create (RefClass(cComCkDateTime)) To hoReleaseTime
    If (Not(IsComObjectCreated(hoReleaseTime))) Begin
        Send CreateComObject of hoReleaseTime
    End
    Get ComSetFromCurrentSystemTime Of hoReleaseTime To iSuccess
    Get ComAddDays Of hoReleaseTime 1 To iSuccess
    Get Create (RefClass(cComChilkatJsonObject)) To hoSchedule
    If (Not(IsComObjectCreated(hoSchedule))) Begin
        Send CreateComObject of hoSchedule
    End
    Get ComGetAsTimestamp Of hoReleaseTime False To sTemp1
    Get ComUpdateString Of hoSchedule "send_at" sTemp1 To iSuccess
    Get ComSetUrlVar Of hoHttp "draft" sReviewedDraftId To iSuccess

    Get pvComObject of hoSchedule to vSchedule
    Get pvComObject of hoResp to vResp
    Get ComHttpJson Of hoHttp "PUT" "https://api.sendgrid.com/v3/marketing/singlesends/{$draft}/schedule" vSchedule "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 Create (RefClass(cComChilkatJsonObject)) To hoScheduled
    If (Not(IsComObjectCreated(hoScheduled))) Begin
        Send CreateComObject of hoScheduled
    End
    Get ComBodyStr Of hoResp To sTemp1
    Get ComLoad Of hoScheduled sTemp1 To iSuccess
    If (iSuccess <> True) Begin
        Showln "Unexpected response: expected JSON."
        Procedure_Return
    End

    Get ComStringOf Of hoScheduled "status" To sTemp1
    Get ComStringOf Of hoScheduled "send_at" To sTemp2
    Showln sTemp1 ": " sTemp2


End_Procedure