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
Copied
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