# Search Email Templates

Searches the email editor design catalogue by tag, category or collection. Returns template IDs, names and thumbnails, paginated with nextPage (12 per page by default). Use the ID, not the result number, to apply or preview a design. Tags are case-sensitive; unknown filters match nothing. Changes no email.

## Input schema:

```json
{
  "type": "object",
  "properties": {
    "tag": {
      "type": [
        "null",
        "string"
      ],
      "description": "Case-sensitive catalogue tag; use the exact spelling from the widget suggestions, e.g. \"light\", \"white\", \"three-columns\"; omit for all",
      "default": null,
      "maxLength": 250
    },
    "category": {
      "type": [
        "null",
        "string"
      ],
      "description": "Narrow by one category as this tool reports them, e.g. \"events\", \"saas\"; omit for all",
      "default": null,
      "maxLength": 250
    },
    "collection": {
      "type": [
        "null",
        "string"
      ],
      "description": "Narrow by one collection as this tool reports them, e.g. \"welcome-series\"; omit for all",
      "default": null,
      "maxLength": 250
    },
    "page": {
      "type": [
        "null",
        "integer"
      ],
      "description": "Which page of the catalogue, from 1; default 1",
      "default": null,
      "minimum": 1
    },
    "pageSize": {
      "type": [
        "null",
        "integer"
      ],
      "description": "How many designs per page, 1-35; default 12",
      "default": null,
      "minimum": 1,
      "maximum": 35
    },
    "accountId": {
      "type": [
        "null",
        "integer"
      ],
      "description": "User ID of the account; omit for the account the access token works in",
      "default": null,
      "minimum": 1
    }
  },
  "additionalProperties": false
}
```

## Output schema:

```json
{
  "type": "object",
  "required": [
    "tag",
    "category",
    "collection",
    "page",
    "total",
    "nextPage",
    "count",
    "templates",
    "html"
  ],
  "properties": {
    "tag": {
      "type": [
        "string",
        "null"
      ]
    },
    "category": {
      "type": [
        "string",
        "null"
      ]
    },
    "collection": {
      "type": [
        "string",
        "null"
      ]
    },
    "page": {
      "type": "integer"
    },
    "total": {
      "type": "integer"
    },
    "nextPage": {
      "type": "integer"
    },
    "count": {
      "type": "integer"
    },
    "templates": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "number",
          "id",
          "name",
          "thumbnailUrl",
          "previewUrl",
          "tags",
          "categories",
          "collections"
        ],
        "properties": {
          "number": {
            "type": "integer"
          },
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "thumbnailUrl": {
            "type": "string"
          },
          "previewUrl": {
            "type": "string"
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "categories": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "collections": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    },
    "html": {
      "type": "string"
    }
  }
}
```