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"
}
}