Views
Create a view
Create a new view on a database or add a widget view to a dashboard.
POST
TypeScript SDK
For a successful request, the response is a View object.
Provide exactly one of the following to specify where the view is created:
database_id— create a view directly on an existing database.view_id— add a widget view inside an existing dashboard view.create_database— create a new linked database block on a page and add the view to it. Setcreate_database.show_data_source_titletofalseto hide the data source title above the new block.
Connection capabilitiesThis endpoint requires a connection to have insert content and update content capabilities. For more information on connection capabilities, see the capabilities guide.
Errors
Returns a 404 HTTP response if the database or view doesn’t exist, or if the connection doesn’t have access. Returns a 400 HTTP response if more than one ofdatabase_id, view_id, or create_database is provided, or if none is provided.
Returns a 400 or 429 HTTP response if the request exceeds the request limits.Authorizations
Headers
The API version to use for this request. The latest version is 2026-03-11.
Available options:
2026-03-11 Body
application/json
Filter to apply to the view. Uses the same format as the data source query filter. Simple property filters appear in the view's filter bar. For example, a status filter can exclude several values with does_not_equal.
- Option 1
- Option 2
- Title
- Rich Text
- Number
- Checkbox
- Select
- Multi Select
- Status
- Date
- People
- Files
- Url
- Email
- Phone Number
- Relation
- Created By
- Created Time
- Last Edited By
- Last Edited Time
- Formula
- Unique Id
- Rollup
- Verification
- Created Time
- Last Edited Time
Response
- Option 1
- Option 2