Get Emails of a Record
Purpose
Emails are introduced as a related list in Leads, Contacts, Deals, Accounts, Quotes, Invoices, Sales Orders, and Purchase Orders. Use this API to get the details of the emails sent from a record in any of these modules. This API returns ten emails per API call.
Request Details
Request URL
To fetch all emails - {api_domain}/crm/{version}/{module_api_name}/{record_id}/Emails
To fetch a specific email - {api_domain}/crm/{version}/{module_api_name}/{record_id}/Emails/{message-id}
Supported modules
Leads, Accounts, Contacts, Deals, Quotes, Invoices, Sales Orders, Purchase Orders, and Custom
Header
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
Scope
scope=ZohoCRM.modules.READ
or
scope=ZohoCRM.modules.{module_name}.READ
and
scope=ZohoCRM.modules.emails.READ
Possible Module Names
leads, accounts, contacts, deals, quotes, invoices, salesorders, purchaseorders, and custom
Parameters
- typestring, optional
Note that when you do not specify any of these parameters, you will receive all emails from the users and the ones sent from CRM in the response.
If the user has not configured email, the response will only contain the scheduled and sent emails from CRM.sent_from_crm - Emails sent from CRM and associated with given record.
scheduled_in_crm - Emails scheduled to be sent from CRM.
drafts - List of all emails that are in draft state.
user_emails - To fetch your emails or the shared user's emails, which are synced via IMAP/POP protocol using email integration.
For the Accounts module, when :
all_contacts_sent_crm_emails - Emails sent from CRM to contacts.
all_contacts_scheduled_crm_emails - Emails that are scheduled to be sent from CRM to contacts.
all_contacts_draft_crm_emails - Draft mails of all contacts associated with an account.
- owner_idinteger, optional
The ID of the user whose emails you want to fetch. Note that you can use this parameter only with type=user_emails.
- indexstring, optional
Each API returns the first ten emails, and the response contains the key "next_index". Use this value for "index" in subsequent calls to fetch other emails.
When you fetch a specific email, the content key in the response represents the body of the email. Please note that you can fetch the email body only when fetching the specific email, and not all the emails of the record.
Sample request to fetch all emails of a record
Copiedcurl "https://www.zohoapis.com/crm/v4/Leads/3652397000002379001/Emails"
-X GET
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"Sample Response
Copied{
"Emails": [
{
"cc": null,
"summary": null,
"owner": {
"name": "Patricia Boyle",
"id": "3652397000000186017"
},
"read": true,
"subject": "test with attachment",
"message_id": "2ccexxx37c9d",
"source": "individual",
"sent": true,
"intent": null,
"sentiment_info": null,
"linked_record": null,
"emotion": null,
"from": {
"user_name": "Patricia Boyle",
"email": "p.boyle@abc.com"
},
"to": [
{
"user_name": "Will Grandon",
"email": "w.grandon@gmail.com"
}
],
"time": "2022-12-06T04:51:14+05:30",
"status": [
{
"first_open": "2022-12-06T06:23:38+05:30",
"count": "1",
"type": "opened",
"last_open": "2022-12-06T06:23:38+05:30"
}
]
},
{
"cc": null,
"summary": null,
"owner": {
"name": "Patricia Boyle",
"id": "3652397000000186017"
},
"read": true,
"subject": "test with attachment",
"message_id": "2cceafxxx3b9b9",
"source": "individual",
"sent": true,
"intent": null,
"sentiment_info": null,
"linked_record": null,
"emotion": null,
"from": {
"user_name": "Patricia Boyle",
"email": "p.boyle@abc.com"
},
"to": [
{
"user_name": "John Smith",
"email": "smith.j@gmail.com"
}
],
"time": "2022-12-06T04:42:35+05:30",
"status": [
{
"type": "delivered"
}
]
},
{..
}
],
"info": {
"per_page": 10,
"next_index": "487a357e145f0949daec41facb432a1e667349598e57461a6f16f38e3ba444231c01809c86faabb8ce0d9236a16fe897",
"count": 10,
"prev_index": "0",
"more_records": true
}
}Possible Errors
- CANNOT_PROCESSHTTP 400
Reasons and resolutions:
The search function that is used to get emails list is temporarily unavailable. Try the API after some time.
The configured mailbox of the current user is deleted. Reconfigure the email.
The POP user's mailbox is deleted and needs to be backed up. If the current user is an admin, they can initiate a backup.
The user is deactivated in Zoho Mail. Remove the user.
IMAP is configured for the mailbox and sync is in process or yet to be initiated. Wait for the sync to complete before fetching the emails related to the record.
you have setup Gmail API and the authentication failed. Reconfigure the Gmail API.
Refer to the "details" key in the response for the exact error and rectify it accordingly.
- INVALID_DATAHTTP 400
The record ID is invalid.
Resolution: Specify a valid ID of the lead, deal, contact, or account in the request URL. - INVALID_DATAHTTP 400
The value for the "type" parameter is invalid.
Resolution: Specify a valid value for the parameters. Refer to the "Parameters" section for the possible values. - NO_PERMISSIONHTTP 403
you do not have permission to view emails for this record in this module.
Resolution: Contact your administrator.
Sample request to fetch a specific email of the record
Copiedcurl "https://www.zohoapis.com/crm/v4/Leads/3652397000002379001/Emails/2cceafa194d037b63f2000181dd818641afa5a84d184e888e618598ebe137c9d"
-X GET
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"Sample Response
Copied{
"Emails": [
{
"attachments": [
{
"size": "24792",
"name": "email_templates.png",
"id": "72daf06xxx349c51ce66"
}
],
"subject": "test with attachment",
"editable": false,
"mail_format": "html",
"intent": "purchase",
"content": "<div style=\"word-wrap: break-word; word-break: break-word; font-family: Verdana, arial, Helvetica, sans-serif; font-size: 13px\"><div><font face=\"Verdana, Geneva, sans-serif\"><br />\ntest with attachment<br />\n<br />\n</font><br />\n<span id=\"ecw_signature\"></span></div></div>",
"sentiment_info": "positive",
"sent_time": "2022-12-06T04:51:14+05:30",
"thread_id": "12343212343",
"emotion": "gratitude",
"reply_to": {
"user_name": null,
"email": ""
},
"from": {
"user_name": "Patricia Boyle",
"email": "p.boyle@abc.com"
},
"to": [
{
"user_name": "John Smith",
"email": "smith.j@gmail.com"
}
],
"status": [
{
"first_open": "2022-12-06T06:23:38+05:30",
"count": "1",
"type": "opened",
"last_open": "2022-12-06T06:23:38+05:30"
}
]
}
]
}