Sign in

v3

latestOpenAPI 3.1.02026-07-31495191.1 MB
Views

Create a view

post/v1/views

Headers

Notion-Version'2026-03-11' required

The API version to use for this request. The latest version is 2026-03-11.

Request body

data_source_idstring required
namestring required

The name of the view.

type'table' | 'board' | 'list' | 'calendar' | 'timeline' | 'gallery' | 'form' | 'chart' | 'map' | 'dashboard' required

One of: table, board, list, calendar, timeline, gallery, form, chart, map, dashboard

database_idstring
view_idstring
filterViewFilterRequest

Filter for the view. Uses the same format as the data source query filter (property filters, timestamp filters, or compound and/or filters). Simple property filters appear in the view's filter bar in the Notion UI. Select, status, and multi_select filter operators accept a single string or an array of strings to filter by multiple values (e.g. { "does_not_equal": ["Done", "Archive"] }).

sortsViewSortRequest[]
quick_filtersobject

Quick filters to pin in the view's filter bar. Keys are property names or IDs. Values are filter conditions (same shape as a property filter but without the property field). Each quick filter appears as a clickable pill above the view, independent of the advanced filter.

Response

OR