DataFlex Requires Chilkat v11.0.0+
DataFlex
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
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