---
title: "views.create"
method: POST
path: "/capabilities/views.create"
tags: ["Capabilities"]
---

# views.create

`POST /capabilities/views.create`

Create a saved document view from document filters. Saved views are reusable inputs for automations and workflows.

## Request body

- object
  - `name` string, required — Saved view name
  - `description` string — Optional saved view description
  - `query` object, required — Saved document filter query
    - `search` string — Text search
    - `docType` string — Document type filter (comma-separated)
    - `paymentStatus` string — Payment status filter (comma-separated)
    - `integrationId` string — Integration ID filter (comma-separated)
    - `merchants` string — Merchant filter (comma-separated)
    - `last4` string — Card last-4 filter (comma-separated)
    - `labels` string — Label filter (comma-separated)
    - `source` string — Source filter (comma-separated: upload,email,whatsapp)
    - `category` string — Category filter (comma-separated)
    - `entityId` string — Entity ID filter (comma-separated)
    - `workspaceMemberId` string — Workspace member filter (comma-separated user IDs)
    - `amountDirection` 'any' | 'in' | 'out' — Amount direction filter
    - `amountEq` string — Exact amount filter in major units
    - `amountMin` string — Minimum amount filter in major units
    - `amountMax` string — Maximum amount filter in major units
    - `fromDate` string — Absolute from date in YYYY-MM-DD format
    - `toDate` string — Absolute to date in YYYY-MM-DD format
    - `relativeDateRange` 'today' | 'yesterday' | 'last_7_days' | 'last_14_days' | 'last_30_days' | 'last_90_days' | 'this_week' | 'last_week' | 'this_month' | 'last_month' | 'this_quarter' | 'last_quarter' | 'this_year' | 'last_year' | 'year_to_date' — Relative date range
  - `sort` object — Optional sort configuration for the saved view
    - `field` string, required — Sort field
    - `direction` union, required — Sort direction: 1 asc, -1 desc
      - 1
      - -1

## Response `200`

Successful response

- object
  - `success` boolean
  - `code` integer
  - `data` object
    - `result` object — Capability-specific result

## Other responses

- `400` — Invalid input
- `401` — Authentication required
- `404` — Resource not found

---

[API](https://skmtc.net/receiptor/apis/receiptor-ai-api.md) · [All operations](https://skmtc.net/receiptor/apis/receiptor-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/receiptor/receiptor-ai-api/versions/da17f0eb65a2/schema)