FRfrontapp
Views

Create team view

Changed on

Create a new view for a team.

Required scope: views:write

post/teams/{team_id}/views

Request

  • Base URL
    https://api2.frontapp.com
  • URL
    https://api2.frontapp.com/teams/{team_id}/views
  • Auth
    HTTP bearer

Path parameters

team_idstring required

The team ID

Request body

namestring required

Name of the view

inbox_idsResourceID[] required

List of inbox IDs to filter by

tag_idsResourceID[]

List of tag IDs to filter by

not_tag_idsResourceID[]

List of tag IDs to exclude

no_tagsboolean

Whether to filter for conversations without tags

assignee_idsResourceID[]

List of assignee IDs to filter by

not_assignee_idsResourceID[]

List of assignee IDs to exclude

highlightstring

Color highlight for the view

Response

A view

idstring required

Unique identifier of the shared view

namestring required

Name of the shared view

highlightstring nullable required

Color highlight for the view

inbox_idsstring[] required

List of inbox IDs included in the view

tag_idsstring[] required

List of tag IDs to filter by

not_tag_idsstring[] required

List of tag IDs to exclude

no_tagsboolean required

Whether to filter for conversations without tags

assignee_idsstring[] required

List of assignee IDs to filter by

not_assignee_idsstring[] required

List of assignee IDs to exclude

Example response

{
  "_links": {
    "self": "https://yourCompany.api.frontapp.com/views/lns_abc123",
    "related": {
      "owner": "https://yourCompany.api.frontapp.com/teams/tim_xyz"
    }
  },
  "id": "lns_abc123",
  "name": "High Priority Support",
  "highlight": "pink"
}

Changes