---
title: "Create a Smart View"
method: POST
path: "/saved_search/"
tags: ["smart_views"]
---

# Create a Smart View

`POST /saved_search/`

Create a Lead or Contact Smart View.

For Lead Smart Views, the `type` field is optional (since `lead` is the default `type`).

When creating a Smart View, you must specify that you want to get objects of the appropriate type via an `object_type` clause as per the [Advanced Filtering](https://developer.close.com/api/resources/advanced-filtering) section. See the examples below.

## Response `200`

Successful response

- SavedSearch
  - `date_created` string, date-time, required
  - `date_updated` string, date-time, required
  - `description` string, nullable, required
  - `id` string, required
  - `is_shared` boolean, required
  - `is_user_dependent` boolean, nullable, required
  - `name` string, required
  - `organization_id` string, required
  - `query` string, nullable, required
  - `s_query` object, nullable, required
  - `selected_fields` object[], nullable
  - `shared_with` string[], nullable
  - `sharing_settings` SharingSettingsEmbeddedResponse
    - `created_at` string, date-time, nullable, required
    - `created_by_id` string, nullable, required
    - `group_ids` string[], required
    - `updated_at` string, date-time, nullable, required
    - `updated_by_id` string, nullable, required
    - `user_ids` string[], required
    - `whole_org` boolean, required
  - `type` 'lead' | 'contact' | 'opportunity' | 'call' | 'email' | 'sms' | 'meeting' | 'note' | 'whatsapp_message' | 'custom_activity' | 'form_submission', required
  - `user_id` string, nullable, required

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `404` — Not found

---

[API](https://skmtc.net/close/apis/close-api.md) · [All operations](https://skmtc.net/close/apis/close-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/close/close-api/revisions/0dcf3303e9d7/schema)