Views

Create a view

Changed on
post/v1/views

Request

  • Base URL
    https://api.notion.com
  • URL
    https://api.notion.com/v1/views
  • Auth
    HTTP bearer

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

Changes

  • c3aed1353a33Revision changes
    • info

      added the new optional request property /

  • c90a4587bc95Revision changes
    • warning

      added the new idempotency_key_reused enum value to the / response property for the response status