> ## Documentation Index
> Fetch the complete documentation index at: https://docs.clustr-ai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Saved View

> Save a filter as a view you own

Creates a view you own, alongside the views your workspace already sees.
Share this one with `is_shared`.

> [!WARNING]
>
> **Set `memberQuery` if you want this view to drive a [Workflow](https://docs.clustr-ai.com/workflows.md).** It's
> the list query these filters compile to: the exact query string [List
> Accounts](https://docs.clustr-ai.com/api-reference/list-accounts.md) or the People search endpoint would
> receive. Without it, a Workflow editor built on this view asks you to re-save it
> before it can determine membership.

```bash cURL theme={null}
curl -X POST "https://api.clustr-ai.com/api/public/saved-views" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "entity": "accounts",
    "name": "Hot accounts",
    "filters": { "fit": ["A+", "A"], "temperature": ["burning"] },
    "is_shared": true,
    "memberQuery": "fit=A%2B&fit=A&temperature=burning"
  }'
```

```json 201 theme={null}
{
  "success": true,
  "data": {
    "view": {
      "clustr_saved_view_id": "view_2smktjqhs4zr4rxsstanj669ya",
      "id": "3e5f1a22-...",
      "entity": "accounts",
      "name": "Hot accounts",
      "is_shared": true,
      "is_owner": true,
      "memberQuery": "fit=A%2B&fit=A&temperature=burning",
      "created_at": "2026-09-13T10:00:00Z",
      "updated_at": "2026-09-13T10:00:00Z"
    }
  }
}
```

```json 400 theme={null}
{
  "success": false,
  "error": { "message": "entity must be one of people, accounts, connectors", "code": "BAD_REQUEST" }
}
```


## OpenAPI

````yaml POST /saved-views
openapi: 3.1.0
info:
  title: Clustr Public API
  description: >
    Programmatic access to your Clustr network: import connectors, search warm
    intros (opportunities), and manage target accounts.


    ## Authentication

    All endpoints require a Bearer token (API key) in the `Authorization`
    header.


    ```

    Authorization: Bearer <your_api_key>

    ```


    API keys can be created and managed from the [API settings
    page](https://app.clustr-ai.com/api).
  version: '1.0'
  contact:
    name: Clustr Support
    url: https://clustr-ai.com
servers:
  - url: https://api.clustr-ai.com/api/public
    description: Production
security:
  - BearerAuth: []
paths:
  /saved-views:
    post:
      tags:
        - Saved Views
      summary: Create Saved View
      description: >-
        Saves a filter as a view you own. Set `memberQuery` to the list query
        these filters produce: a view needs it to drive a
        [Workflow](/workflows), and a view saved without one can drive a
        Workflow once it is saved again with it.
      operationId: createSavedView
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateSavedViewRequest'
      responses:
        '201':
          description: The new view
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  data:
                    type: object
                    properties:
                      view:
                        $ref: '#/components/schemas/SavedView'
        '400':
          description: Invalid entity or filters
        '401':
          description: Invalid or missing API key
components:
  schemas:
    CreateSavedViewRequest:
      type: object
      required:
        - entity
        - name
      properties:
        member_query:
          type: string
          deprecated: true
          description: The same as `memberQuery`. `memberQuery` is the name to use.
        sourceKey:
          type: string
          description: >-
            Marks the view as the written-down copy of a generated Targeting
            view, for example `accounts:icp:<icpId>`. Create only.
        entity:
          type: string
          description: 'The table the view filters: `people`, `accounts` or `connectors`.'
          enum:
            - accounts
            - people
            - connectors
        name:
          type: string
          description: Display name.
        filters:
          type: object
          description: >-
            The view's filter, sort and search state. Send it back exactly as
            you received it:

            build it by filtering the table in the app and reading back what the
            app saved,

            rather than writing it manually.
        is_shared:
          type: boolean
          description: >-
            Visible to your whole workspace when true. Defaults to false
            (private).
        is_pinned:
          type: boolean
          description: Shown in the sidebar navigation tree.
        memberQuery:
          type: string
          description: >-
            The list query this view's filters compile to. Required before the
            view can drive a Workflow.
    SavedView:
      type: object
      description: >-
        A named, reusable filter over one table. It is live: its results always
        reflect the current data.
      required:
        - id
        - entity
        - name
      properties:
        clustr_saved_view_id:
          type: string
          description: >-
            The saved view's Clustr ID, for example
            `view_6z690mh248rn76wv5ykft2dd9b`. Use it to refer to

            this saved view.
          example: view_6z690mh248rn76wv5ykft2dd9b
        clustr_workspace_id:
          type: string
          description: >-
            The workspace's Clustr ID, for example
            `ten_wjxw7ak147g7j0ba9v522f5kg6`.
          example: ten_wjxw7ak147g7j0ba9v522f5kg6
        clustr_user_id:
          type: string
          description: >-
            The Clustr ID of the member who owns the view, for example
            `usr_n983cfnsr2hzbrgtq0h8vf95hs`.

            Empty means the workspace owns the view, and every member of the
            workspace may edit it.
          example: usr_n983cfnsr2hzbrgtq0h8vf95hs
        id:
          type: string
          format: uuid
          description: >-
            Kept for integrations built before Clustr IDs. New integrations
            should use `clustr_saved_view_id`.
        tenant_id:
          type: string
          format: uuid
          description: >-
            Kept for integrations built before Clustr IDs. New integrations
            should use `clustr_workspace_id`.
        user_id:
          type: string
          description: >-
            Kept for integrations built before Clustr IDs. New integrations
            should use `clustr_user_id`.
        entity:
          type: string
          enum:
            - accounts
            - people
            - connectors
        name:
          type: string
        filters:
          type: object
          description: >-
            The view's filter, sort and search state, as an opaque object. Send
            it back exactly as you received it, and build it by saving a view in
            the app.
        is_shared:
          type: boolean
          description: >-
            Visible to the whole workspace when true. Only the owner may edit or
            delete it either way.
        is_pinned:
          type: boolean
          description: Shown in the sidebar navigation tree.
        is_owner:
          type: boolean
          description: Whether the caller may edit or delete this view.
        memberQuery:
          type: string
          nullable: true
          description: >-
            The list query this view stands for, set by the app or client that
            saves the view. Null when the view was saved without one; such a
            view can drive a Workflow once it is saved again with a
            `memberQuery`.
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: The API key you created on the API settings page of the Clustr app.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.