---
title: "Create team view"
method: POST
path: "/teams/{team_id}/views"
tags: ["Views"]
---

# Create team view

`POST /teams/{team_id}/views`

Create a new view for a team.

Required scope: `views:write`

## Path parameters

- `team_id` string, required

## Request body

- CreateView
  - `name` string, required — Name of the view
  - `inbox_ids` ResourceID[], required — List of inbox IDs to filter by
  - `tag_ids` ResourceID[] — List of tag IDs to filter by
  - `not_tag_ids` ResourceID[] — List of tag IDs to exclude
  - `no_tags` boolean — Whether to filter for conversations without tags
  - `assignee_ids` ResourceID[] — List of assignee IDs to filter by
  - `not_assignee_ids` ResourceID[] — List of assignee IDs to exclude
  - `highlight` string — Color highlight for the view

## Response `201`

A view

- SharedViewResponse
  - `_links` object, required
    - `self` string — Link to resource
    - `related` object
      - `owner` string, nullable — Link to the team that owns the view
  - `id` string, required — Unique identifier of the shared view
  - `name` string, required — Name of the shared view
  - `highlight` string, nullable, required — Color highlight for the view
  - `inbox_ids` string[], required — List of inbox IDs included in the view
  - `tag_ids` string[], required — List of tag IDs to filter by
  - `not_tag_ids` string[], required — List of tag IDs to exclude
  - `no_tags` boolean, required — Whether to filter for conversations without tags
  - `assignee_ids` string[], required — List of assignee IDs to filter by
  - `not_assignee_ids` string[], required — List of assignee IDs to exclude

---

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