Get a Specific Email

Purpose

This API is used to retrieve a specific email using the message ID.

OAuth Scope

Use the scope

MailApps.messages.ALL (or) MailApps.messages.READ

ALL - Full access to the messages.

READ - Read emails.

To generate Authtoken, refer here.

Request URL

Method: GET

https://mail360.zoho.com/api/accounts/{account_key}/messages/{messageId}

Path Parameters

  • account_key* string
    • This key is used to identify the account from which the emails have to be retrieved. It is generated during account addition.
    • This parameter can be fetched from Get all accounts API.
  • messageId* long
    • This is a unique key used to identify a specific email.

 

* - Mandatory parameter

Note:

While the Messages APIs focus on individual messages, the Threads APIs deal with entire conversation threads, each of which contains multiple messages.

Sample request

Copiedcurl "https://mail360.zoho.com/api/accounts/x7**00s/messages/16756****0001" \
-X GET \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization:Zoho-oauthtoken 8***f47d1a896d59" \

Sample response

Copied{
 "status": {
 "code": 200,
 "description": "success"
 },
 "data": {
 "summary": "New device signed in to rebecca@gmail.com
Your Google Account was just signed in to from a new Linux device.
You're getting this email to make sure it was you.Check activityYou
can also see security activity at https://myaccount.google.com/noti",
 "sentDateInGMT": "1632707012000",
 "calendarType": 0,
 "subject": "Security alert",
 "messageId": "1632727152728010003",
 "flagid": "flag_not_set",
 "status2": "0",
 "priority": "3",
 "hasInline": "true",
 "toAddress": "&rebecca@gmail.com>",
 "folderId": "10022000000002045",
 "ccAddress": "Not Provided",
 "hasAttachment": "0",
 "size": "6310",
 "sender": "Google",
 "receivedTime": "1632726812000",
 "fromAddress": "no-reply@accounts.google.com",
 "status": "0"
 }
 }