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

Insert Email into GMail Folder

See more GMail REST API Examples

Directly inserts a message into only this user's mailbox similar to IMAP APPEND, bypassing most scanning and classification. Does not send a message.

This example will create a Chilkat Email object and upload/insert it into GMail. Then adds the "INBOX" label to the email to make it appear in INBOX

Chilkat B4X Downloads

B4X
Dim success As Boolean = False

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

Dim email As ChilkatEmail
email.Initialize

'  This example chooses to load an email from a file.
success = email.LoadEml("qa_data/eml/testEmail.eml")
If success = False Then
    Log(email.LastErrorText)
    Return
End If


'  Get the email as MIME.
Dim sbMime As ChilkatStringBuilder
sbMime.Initialize
email.GetMimeSb(sbMime)

Dim http As ChilkatHttp
http.Initialize("http")
Dim resp As ChilkatHttpResponse
resp.Initialize

http.AuthToken = "GMAIL-ACCESS-TOKEN"

'  Upload to GMail (does not send, but just inserts).

'  IMPORTANT: After uploading/inserting, you won't see the message in the Inbox.
'  In your web browser, if you go to "All Mail", you will see it.

Dim url As String = "https://www.googleapis.com/upload/gmail/v1/users/me/messages?uploadType=media"
http.UncommonOptions = "SendGzipped"
success = http.HttpSb("POST", url, sbMime, "utf-8", "message/rfc822", resp)
If success = False Then
    Log(http.LastErrorText)
    Return
End If

http.UncommonOptions = ""

'  A status code of 200 indicates success.
Log("Response status code: " & resp.StatusCode)
Log("Response body:")
Log(resp.BodyStr)

'  The response body contains JSON.
'  A sample successful JSON response:

'  {
'   "id": "166f583051d36144",
'   "threadId": "166f5529e079a456"
'  }

Dim json As ChilkatJsonObject
json.Initialize
json.Load(resp.BodyStr)
Dim id As String = json.StringOf("id")

'  Add the Inbox label to the inserted email so that it appears in Inbox.
Log("---- Adding the Inbox label to the newly inserted email. ----")

'  Create the following JSON to be sent in a POST to modify labels for this message.
'  {
'    "addLabelIds": [
'      "INBOX"
'      ]
'  }

Dim json2 As ChilkatJsonObject
json2.Initialize
json2.UpdateString("addLabelIds[0]", "INBOX")

http.SetUrlVar("id", id)
url = "https://www.googleapis.com/gmail/v1/users/me/messages/{$id}/modify"

success = http.HttpJson("POST", url, json2, "application/json", resp)
If success = False Then
    Log(http.LastErrorText)
    Return
End If


'  A status code of 200 indicates success.
Log("Response status code: " & resp.StatusCode)
Log("Response body:")
Log(resp.BodyStr)

'  The response body contains JSON.
'  A sample successful JSON response:

'  {
'   "id": "166f583051d36144",
'   "threadId": "166f583051d36144",
'   "labelIds": [
'    "INBOX"
'   ]
'  }