Get Email Drafts
Purpose
To fetch email drafts associated with a record in your CRM account.
Request Details
Request URL
{api-domain}/crm/{version}/{module}/{record-id}/__email_drafts
To fetch a specific draft:
{api-domain}/crm/{version}/{module}/{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
scope= ZohoCRM.Modules.ALL
(or)
scope=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 Keys
- 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_URL_PATTERNHTTP 404
Please check if the URL trying to access is a correct one
Resolution: The request URL specified is incorrect. Specify a valid request URL. Refer to request URL section above. - OAUTH_SCOPE_MISMATCHHTTP 401
Unauthorized
Resolution: Client does not have the required OAUTH SCOPE. Create a new client with valid scope. Refer to scope section above for more details. - INTERNAL_ERRORHTTP 500
Internal Server Error
Resolution: Unexpected and unhandled exception in Server. Contact support team. - INVALID_REQUEST_METHODHTTP 400
The http request method type is not a valid one
Resolution: You have specified an invalid HTTP method to access the API URL. Specify a valid request method. Refer to endpoints section above. - INVALID_DATAHTTP 400
The related id given seems to be invalid
Resolution: Specify a valid Record ID in the request URL. - INVALID_MODULEHTTP 400
The module name given seems to be invalid
Resolution: Specify a valid module api name in the request URL.
Sample response
Copied