younifyd
Menu

List email templates

List email templates

GET/settings/email_templates

Use it in a workflow

  1. Add a step and choose the Zoho CRM connector.
  2. Pick the List email templates action (under Email).
  3. Fill in the fields below, then reference the result from later steps as {{listEmailTemplates.response.data}}.

Request

Query parameters

modulestring

Provide the API name of the CRM module to filter Email Templates by. Refer to the [Get Modules](modules.yaml#$.paths./settings/modules.get) resource for module API name.

per_pageinteger (int32)

Provide the maximum number of Email Template records to return per page. Default value is **200** and the maximum value is **200.**

Default 200

pageinteger (int32)

Specify the page number to retrieve in a paginated response. The default value is <b>1</b>.

Default 1

Response

Returns 200 with an object. Read it in later steps with {{listEmailTemplates.response.data.<field>}}.

email_templatesarray<object>

Represents the list of email templates matching the request criteria.

created_timestring (date-time)required

Represents the timestamp indicating when Zoho CRM created the Email Template.

modified_timestring (date-time)required

Represents the timestamp indicating when the Email Template was last modified.

last_usage_timestring | nullrequired

Represents the timestamp indicating when the Email Template was last used.

categorystringrequired

Template category - normal, draft, marketplace, plugin, or default

One ofnormaldraftmarketplacepluginsystem_templates

folderobjectrequired2 fields

Represents a reference to the folder in which the Email Template is stored.

moduleobjectrequired2 fields

Represents a reference to the CRM module associated with the Email Template. Refer to the [Get Modules](modules.yaml#$.paths./settings/modules.get) resource for valid values.

created_byobjectrequired2 fields

Represents a reference to the Zoho CRM user associated with the Email Template.

modified_byobjectrequired2 fields

Represents a reference to the Zoho CRM user associated with the Email Template.

namestringrequired

Represents the display name of the Email Template.

idstringrequired

Represents the unique ID of the Email Template.

editor_modestringrequired

Represents the editor mode used to create the Email Template. Possible values: **plain_text** - The template uses plain text format. **rich_text** - The template uses rich text format. **gallery** - The template uses the gallery drag-and-drop editor.

One ofplain_textrich_textgallery

favoritebooleanrequired

Indicates whether the Email Template is marked as a favorite by the authenticated user. Possible values: **true** - The template is marked as a favorite. **false** - The template is not marked as a favorite.

attachmentsarray | nullrequired

Represents the list of attachments associated with the Email Template.

subjectstringrequired

Represents the email subject line of the template.

associatedbooleanrequired

Indicates whether the Email Template is currently associated with one or more CRM components. Possible values: **true** - The template is associated with one or more CRM components. **false** - The template is not associated with any CRM component.

activebooleanrequired

Indicates whether the Email Template is active. Possible values: **true** - The template is active. **false** - The template is inactive/deleted.

consent_linkedbooleanrequired

Indicates whether this Email Template is linked to a consent form. Possible values: **true** - The template is linked to a consent form. **false** - The template is not linked to a consent form.

last_version_statisticsobjectrequired6 fields

Represents the email delivery and engagement statistics from the most recent version of the template.

infoobject

Represents the pagination metadata for the email templates list response.

per_pageinteger (int32)required

Represents the number of Email Template records returned per page.

pageinteger (int32)required

Represents the current page number of the paginated response.

countinteger (int32)required

Represents the number of Email Template records returned in the current page.

more_recordsbooleanrequired

Indicates whether additional pages of results are available. Possible values: **true** - More records are available on subsequent pages. **false** - The current page contains the last available records.

json
{
  "email_templates": [
    {
      "created_time": "2025-01-01T00:00:00Z",
      "modified_time": "2025-01-01T00:00:00Z",
      "last_usage_time": "2025-01-01T00:00:00Z",
      "category": "normal",
      "folder": {
        "name": "string",
        "id": "string"
      },
      "module": {
        "api_name": "string",
        "id": "string"
      },
      "created_by": {
        "name": "string",
        "id": "string"
      },
      "modified_by": {
        "name": "string",
        "id": "string"
      },
      "name": "string",
      "id": "string",
      "editor_mode": "plain_text",
      "favorite": false
    }
  ],
  "info": {
    "per_page": 0,
    "page": 0,
    "count": 0,
    "more_records": false
  }
}

Need more? See the Zoho CRM guide for connection setup and behaviour shared by every action.