(PureBasic) Mailgun Send Email using MIME

See more Mailgun Examples

Send an email using MIME. This allows for the Chilkat email object to be used to construct the email. Then it can be sent using Mailgun.

For more information, see https://documentation.mailgun.com/en/latest/api-sending.html#sending

Chilkat PureBasic Module Download

Chilkat PureBasic Module

IncludeFile "CkJsonObject.pb"
IncludeFile "CkHttp.pb"
IncludeFile "CkEmail.pb"
IncludeFile "CkHttpRequest.pb"
IncludeFile "CkHttpResponse.pb"
IncludeFile "CkStringBuilder.pb"

Procedure ChilkatExample()

    ; This example assumes the Chilkat API to have been previously unlocked.
    ; See Global Unlock Sample for sample code.

    ; We're going to create an email that contains an .zip attachment,
    ; and also both plain-text and HTML alternative bodies.
    ; The HTML body will include an image.

    email.i = CkEmail::ckCreate()
    If email.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    ; Adding attachments, HTML/plain-text bodies, etc can be done
    ; in any order:

    ; Add an attachment
    contentType.s = CkEmail::ckAddFileAttachment(email,"qa_data/hamlet.zip")
    If CkEmail::ckLastMethodSuccess(email) <> 1
        Debug CkEmail::ckLastErrorText(email)
        CkEmail::ckDispose(email)
        ProcedureReturn
    EndIf

    ; Add some headers:
    CkEmail::setCkSubject(email, "This is a complex email")
    ; Please change this email address before testing.
    success.i = CkEmail::ckAddTo(email,"Joe Example","joe@example.com")
    CkEmail::setCkFrom(email, "Your Name <mailgun@YOUR_DOMAIN_NAME>")

    ; Add a plain-text body:
    CkEmail::ckAddPlainTextAlternativeBody(email,"This is the plain-text body")

    ; Add an image that will be embedded in the HTML body.
    success = CkEmail::ckAddRelatedFile2(email,"qa_data/jpg/starfish.jpg","starfish.jpg")
    If success <> 1
        Debug CkEmail::ckLastErrorText(email)
        CkEmail::ckDispose(email)
        ProcedureReturn
    EndIf

    ; Add an HTML body:
    html.s
    html = "<html><body><b>This is the HTML body</b><br><img src=" + Chr(34) + "starfish.jpg" + Chr(34) + "></body></html>"

    CkEmail::ckAddHtmlAlternativeBody(email,html)

    ; ------------------------------------------------------------------------
    ; Send the above email using Mailgun

    http.i = CkHttp::ckCreate()
    If http.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    ; Implements the following CURL command:

    CkHttp::setCkLogin(http, "api")
    CkHttp::setCkPassword(http, "sending_api_key")    ;  Replace with your actual sending API key.

    req.i = CkHttpRequest::ckCreate()
    If req.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkHttpRequest::setCkHttpVerb(req, "POST")
    CkHttpRequest::setCkPath(req, "/v3/YOUR_DOMAIN_NAME/messages.mime")
    CkHttpRequest::setCkContentType(req, "multipart/form-data")

    CkHttpRequest::ckAddParam(req,"from","Your Name <mailgun@YOUR_DOMAIN_NAME>")
    CkHttpRequest::ckAddParam(req,"to","Joe Example <joe@example.com>")
    CkHttpRequest::ckAddStringForUpload2(req,"message","message.eml",CkEmail::ckGetMime(email),"utf-8","application/octet-stream")

    resp.i = CkHttp::ckSynchronousRequest(http,"api.mailgun.net",443,1,req)
    If CkHttp::ckLastMethodSuccess(http) = 0
        Debug CkHttp::ckLastErrorText(http)
        CkEmail::ckDispose(email)
        CkHttp::ckDispose(http)
        CkHttpRequest::ckDispose(req)
        ProcedureReturn
    EndIf

    sbResponseBody.i = CkStringBuilder::ckCreate()
    If sbResponseBody.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkHttpResponse::ckGetBodySb(resp,sbResponseBody)
    jResp.i = CkJsonObject::ckCreate()
    If jResp.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkJsonObject::ckLoadSb(jResp,sbResponseBody)
    CkJsonObject::setCkEmitCompact(jResp, 0)

    Debug "Response Body:"
    Debug CkJsonObject::ckEmit(jResp)

    respStatusCode.i = CkHttpResponse::ckStatusCode(resp)
    Debug "Response Status Code = " + Str(respStatusCode)
    If respStatusCode >= 400
        Debug "Response Header:"
        Debug CkHttpResponse::ckHeader(resp)
        Debug "Failed."
        CkHttpResponse::ckDispose(resp)

        CkEmail::ckDispose(email)
        CkHttp::ckDispose(http)
        CkHttpRequest::ckDispose(req)
        CkStringBuilder::ckDispose(sbResponseBody)
        CkJsonObject::ckDispose(jResp)
        ProcedureReturn
    EndIf

    CkHttpResponse::ckDispose(resp)

    ; Sample JSON response:
    ; (Sample code for parsing the JSON response is shown below)

    ; {
    ;   "id": "<20210429234809.1.2D550E1C94D3D98F@sandbox0e542e4c577f4bbb98c8bf6b6bca727b.mailgun.org>",
    ;   "message": "Queued. Thank you."
    ; }

    ; Sample code for parsing the JSON response...
    ; Use the following online tool to generate parsing code from sample JSON:
    ; Generate Parsing Code from JSON

    id.s = CkJsonObject::ckStringOf(jResp,"id")
    message.s = CkJsonObject::ckStringOf(jResp,"message")


    CkEmail::ckDispose(email)
    CkHttp::ckDispose(http)
    CkHttpRequest::ckDispose(req)
    CkStringBuilder::ckDispose(sbResponseBody)
    CkJsonObject::ckDispose(jResp)


    ProcedureReturn
EndProcedure