Get Email Drafts
Purpose
To fetch email drafts associated with a record in Zoho CRM account.
Endpoints
- GET /{module_API_name}/{record_ID}/__email_drafts
- GET /{module_API_name}/{record_ID}/__email_drafts/{draft_ID}
Request Details
Request URL
{api-domain}/crm/{version}/{module_API_name}/{record_ID}/__email_drafts
To fetch a specific draft:
{api-domain}/crm/{version}/{module_API_name}/{record_ID}/__email_drafts/{draft_ID}
Supported modules
Leads, Contacts, Deals, Accounts, Sales Orders, Purchase Orders, Invoices, Quotes, Cases, and Custom.
Header
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
Scope
ZohoCRM.Modules.ALL
(or)
ZohoCRM.Modules.{module_name}.{operation_type}
Possible Module Names
leads, accounts, contacts, deals, quotes, salesorders, purchaseorders, invoices, cases, and custom
Possible operation types
ALL - Full access to the module
GET - Get Module data
Parameters
- pageinteger, optional
To get the list of records from the respective pages. The default value is 1.
Possible values: Positive integer values only. - per_pageinteger, optional
To get the list of records available per page. The default and the maximum possible value is 10.
Possible values: Positive integer values only.
Note
- You can fetch up to 10 email drafts in a single API call. To fetch more drafts, use per_page and page parameters.
Sample Request
Copiedcurl "https://www.zohoapis.com/crm/v8/Leads/2309216000000488477/__email_drafts/4f8efdcbaf23fd33c939217d4e14222d6d7c4ad5575b2ba66956d9f097ebf644"
-X GET
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"
Response JSON
- schedule_detailsJSON object
The scheduling details for the email
- timeDateTime
The schedule time for the draft.
- summarystring
Displays the first 250 characters of the email content.
- ccJSON array
The user name and email address to cc the email to.
- created_timedatetime
The date and time at which the email draft was created.
- bccJSON array
The user name and email address to bcc the email to.
- attachmentsJSON array
The attachments for the email draft.
- idString
The unique of the attachment.
- file_nameString
The file name of the attachment.
- file_sizeString
The attachment size in megabytes.
- service_nameString
The service through which the file is uploaded to the ZFS.
- subjectString
The subject of the email.
- contentString
The content of the email draft.
- modified_timedatetime
The date and time at which the email draft was last modified.
- reply_toemail address
The email address that you want the user would reply to after receiving the mail.
- rich_textBoolean
Specifies whether the format of the email is rich text or not. The possible options are :
true :rich text
false : plain text - inventory_detailsJSON object, optional
Represents the details of the inventory template such as the template ID, paper type, and the view type.
- fromemail address
The from address for the email draft.
- idstring
The unique ID of the email draft.
- toJSON array
The user name and email address to which the email is drafted to be sent.
Possible Errors
- INVALID_REQUEST_METHODHTTP 400
The request method is incorrect.
Resolution: Use the HTTP GET method to make this API call. Any other request method will result in this error. - INVALID_DATAHTTP 400
You have specified an invalid record ID in the request URL.
Resolution: Specify a valid Record ID in the request URL. - INVALID_MODULEHTTP 400
You have specified an invalid module API name in the request URL.
Resolution: Specify a valid module API name in the request URL. - OAUTH_SCOPE_MISMATCHHTTP 401
The access token you have used to make this API call does not have the required scope.
Resolution: Generate a new access token with the required scopes for this API. Refer to the Scope section at the beginning of this page for the list of required scopes. - INVALID_URL_PATTERNHTTP 404
The request URL is incorrect.
Resolution: Specify a valid request URL. Refer to the request URL section at the beginning of this page for more details. - INTERNAL_ERRORHTTP 500
Unexpected and unhandled exception in the server.
Resolution: Contact the support team at support@zohocrm.com.
Sample response
Copied{
"__email_drafts": [
{
"schedule_details": {
"time": "2023-11-30T18:40:00+05:30"
},
"template": null,
"summary": "This is the email content.",
"cc": [
{
"user_name": "user2",
"email": "user2@zylker.com"
}
],
"created_time": "2023-11-09T14:45:25+05:30",
"bcc": [
{
"user_name": "user4",
"email": "user4email@zoho.com"
}
],
"attachments": [
{
"file_name": "attachment.txt",
"service_name": "ZFSAttached",
"id": "0b9e5596cdd8cafe6a5c09f78f095bd6434c863110a6d1e094285c6ebf9dd0d5db4eff3bbccadddbf58afe55b1dd7c71",
"file_size": "8990"
}
],
"subject": "Test Draft",
"content": "This is the email content.",
"email_opt_out": false,
"modified_time": "2023-11-09T14:45:25+05:30",
"reply_to": "pat.boyle@zylker.com",
"rich_text": true,
"inventory_details": null,
"from": "patricia.boyle@zylker.com",
"id": "4f8efdcbaf23fd33c939217d4e14222d6d1cb21e4a45914fb9ba0c31c3c47330",
"to": [
{
"user_name": "user1",
"email": "user1@zylker.com"
}
]
}
]
}