Skip to main content
A view is a named set of filters on the Contacts, Companies or Tasks list, shown as a tab of that page. Each user sees the lemlist default views, the views shared with the team and their own private views, and picks which ones show as tabs. Use List Views to read them, Get View Fields to discover the fields a view can filter on, and Create View to save one. Every view carries a url that opens the list on it. The views endpoints act for the user the API key belongs to. The lemlist MCP server exposes the same operations as tools (get_views, get_view_fields, create_view, update_view, duplicate_view, delete_view, set_view_tabs).

A saved view of the Contacts, Companies or Tasks list: a named set of filters, shown as a tab.

id
string
required

View id

Example:

"evw_A1B2C3ExAmPlE9xYz"

name
string
required

Name shown on the tab

Example:

"Hot leads in Paris"

visibility
enum<string>
required

me: private to its owner. everyone: shared with the team, which needs the "Create views for the team" permission. Defaults to me on create.

Available options:
me,
everyone
Example:

"me"

isDefault
boolean
required

A lemlist default view, read-only: it can be pinned, hidden or duplicated

canEdit
boolean
required

Whether the API key's user may edit or delete it

pinned
boolean
required

Shown as one of the user's tabs

filterState
object
required

The filters as the page saved them. basicFilters are AND-ed conditions; advancedFilters is a tree of conditions and groups combined by rootConnector.

url
string
required

Opens the list on that view in lemlist

Example:

"https://app.lemlist.com/teams/tea_ExAmPlE4f7Kq2Wz9x/lemcrm/contacts?view=evw_A1B2C3ExAmPlE9xYz"

icon
string

Font Awesome icon shown on the tab

Example:

"far fa-fire"

sort
object

The sort saved in lemlist, absent when the view uses the page default

columns
object[]

The visible columns saved in lemlist, in order; absent when the view follows the user's columns