---
updatedAt: 2026-01-27T03:08:53.000Z
agentTools:
  projectIndex: https://developer.mixmax.com/llms.txt
---

# /snippets (aka Templates)

Lists templates or snippets that you have access to (including those shared with you)

<Table align={["left","left","left"]}>
  <thead>
    <tr>
      <th style={{ textAlign: "left" }}>
        Parameter
      </th>

      <th style={{ textAlign: "left" }}>
        Type
      </th>

      <th style={{ textAlign: "left" }}>
        Description
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td style={{ textAlign: "left" }}>
        * id
      </td>

      <td style={{ textAlign: "left" }}>
        *String*
      </td>

      <td style={{ textAlign: "left" }}>
        Unique ID.
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        userId
      </td>

      <td style={{ textAlign: "left" }}>
        *String*
      </td>

      <td style={{ textAlign: "left" }}>
        User \_id of the snippet owner. Note that this isn't always your userId, since the template might be shared with you.
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        createdAt
      </td>

      <td style={{ textAlign: "left" }}>
        *Date*
      </td>

      <td style={{ textAlign: "left" }}>
        Timestamp of when the snippet was created.
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        savedAt
      </td>

      <td style={{ textAlign: "left" }}>
        *Date*
      </td>

      <td style={{ textAlign: "left" }}>
        Timestamp of when the snippet last modified.
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        savedBy
      </td>

      <td style={{ textAlign: "left" }}>
        *String*
      </td>

      <td style={{ textAlign: "left" }}>
        ID of the user that last saved the snippet.
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        deletedAt
      </td>

      <td style={{ textAlign: "left" }}>
        *Date*
      </td>

      <td style={{ textAlign: "left" }}>
        Timestamp of when the snippet was deleted.
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        title
      </td>

      <td style={{ textAlign: "left" }}>
        *String*
      </td>

      <td style={{ textAlign: "left" }}>
        The string to use for the *subject* of the message this template is inserted into.
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        source
      </td>

      <td style={{ textAlign: "left" }}>
        *String*
      </td>

      <td style={{ textAlign: "left" }}>
        HTML source of the template.
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        name
      </td>

      <td style={{ textAlign: "left" }}>
        *String*
      </td>

      <td style={{ textAlign: "left" }}>
        The name of this template. Not used anywhere when the template is inserted.
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        shared
      </td>

      <td style={{ textAlign: "left" }}>
        *Object*
      </td>

      <td style={{ textAlign: "left" }}>
        See [docs](/docs/shared).
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        customShortcut
      </td>

      <td style={{ textAlign: "left" }}>
        *String*
      </td>

      <td style={{ textAlign: "left" }}>
        The shortcut this snippet can be identified by for quick insertion.
      </td>
    </tr>
  </tbody>
</Table>

## Searching

The search string will match either name or the subject of the snippet. In addition, the following search operators are supported (see below). Multiple-word values for search operators must be escaped in quotes (e.g. name:"my sales template"). This does not currently support searching the body of the snippet.

<Table align={["left","left"]}>
  <thead>
    <tr>
      <th>
        What you can search by
      </th>

      <th>
        Search operator & example
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        *The snippet's name*
      </td>

      <td>
        `name:"my template name"`

        This search only applies to the snippet's name. Matches *case-sensitively*. Only one `name:` search operator supported.
      </td>
    </tr>

    <tr>
      <td>
        *The snippet's subject*
      </td>

      <td>
        `name:"my template subject"`

        This search only applies to the snippet's subject.\
        Matches *case-sensitively*. Only one `subject:` search operator supported.
      </td>
    </tr>

    <tr>
      <td>
        *The snippet's tag*
      </td>

      <td>
        `folder:"my awesome sales pitches"`

        Search snippets in the specified folder. Matches folder name *case-sensitively*. Only one `folder:` search operator supported.
      </td>
    </tr>

    <tr>
      <td>
        *The snippet's creator*
      </td>

      <td>
        `owner:myself`\
        `owner:"my team"`\
        `owner:hello@mixmax.com`

        Search snippets belonging to yourself, your team, or a particular email. Matches *case-insensitively*. Only one `owner:` search operator supported.
      </td>
    </tr>

    <tr>
      <td>
        *The snippet's custom shortcut*
      </td>

      <td>
        `customShortcut:"hi"`

        This search only applies the the snippet's custom shortcut, matches case insensitively.
      </td>
    </tr>
  </tbody>
</Table>