List pinned company views

GET

companies

views

pinned

curl --request GET \
  --url 'https://api.claap.io/v1/companies/views/pinned?userEmail=jane.doe%40example.com' \
  --header 'X-Claap-Key: <api-key>'

{
  "result": [
    {
      "viewId": "Vw5Rm1Xq8Ld4Tn2Hc6Jp9",
      "name": "Target accounts",
      "visibility": "Public",
      "icon": ":dart:",
      "isDefault": false,
      "ownerId": "Xk2Rd7Mv4Bn9Ts1Lq6Wf3",
      "columns": [
        {
          "type": "Default",
          "columnId": "Name",
          "isHidden": false
        },
        {
          "type": "Default",
          "columnId": "Domain",
          "isHidden": false
        },
        {
          "type": "Default",
          "columnId": "Deals",
          "isHidden": false
        }
      ],
      "filters": {
        "dealStatusIn": [
          "Open"
        ],
        "hasInteraction": true
      },
      "sort": [
        {
          "field": "Name",
          "order": "Asc"
        }
      ]
    },
    {
      "viewId": "Default_Recent",
      "name": "Recent",
      "visibility": "Public",
      "icon": ":clock1:",
      "isDefault": true,
      "ownerId": "#global",
      "columns": [
        {
          "type": "Default",
          "columnId": "Name",
          "isHidden": false
        },
        {
          "type": "Default",
          "columnId": "Domain",
          "isHidden": false
        },
        {
          "type": "Default",
          "columnId": "LastInteraction",
          "isHidden": false
        }
      ],
      "filters": {},
      "sort": [
        {
          "field": "LastInteraction",
          "order": "Desc"
        }
      ]
    },
    {
      "viewId": "Qz2Kw7Fn3Bd9Mx5Lt1Gh4",
      "name": "Won customers",
      "visibility": "Private",
      "isDefault": false,
      "ownerId": "Xk2Rd7Mv4Bn9Ts1Lq6Wf3",
      "columns": [
        {
          "type": "Default",
          "columnId": "Name",
          "isHidden": false
        },
        {
          "type": "Default",
          "columnId": "Contacts",
          "isHidden": false
        }
      ],
      "filters": {
        "dealStatusIn": [
          "Won"
        ]
      },
      "sort": [
        {
          "field": "DealCreatedAt",
          "order": "Desc"
        }
      ]
    }
  ]
}

Lists the company views a user has pinned to the tab bar of the companies table, in tab order. A user who never changed their tab bar gets the built-in default views. Pinned views follow the same access rules as the Claap application: they include the private views the user can access, and leave out views the user can no longer access. See pinned views.

curl --request GET \
  --url 'https://api.claap.io/v1/companies/views/pinned?userEmail=jane.doe%40example.com' \
  --header 'X-Claap-Key: <api-key>'

Authorizations

X-Claap-Key

string

header

required

Query Parameters

userEmail

string<email>

required

Email address of the user whose pinned views are listed. It must belong to an active workspace member.

Example:

"jane.doe@example.com"

Response

Pinned company views were successfully retrieved

result

object[]

required

Show child attributes

curl --request GET \
  --url 'https://api.claap.io/v1/companies/views/pinned?userEmail=jane.doe%40example.com' \
  --header 'X-Claap-Key: <api-key>'

{
  "result": [
    {
      "viewId": "Vw5Rm1Xq8Ld4Tn2Hc6Jp9",
      "name": "Target accounts",
      "visibility": "Public",
      "icon": ":dart:",
      "isDefault": false,
      "ownerId": "Xk2Rd7Mv4Bn9Ts1Lq6Wf3",
      "columns": [
        {
          "type": "Default",
          "columnId": "Name",
          "isHidden": false
        },
        {
          "type": "Default",
          "columnId": "Domain",
          "isHidden": false
        },
        {
          "type": "Default",
          "columnId": "Deals",
          "isHidden": false
        }
      ],
      "filters": {
        "dealStatusIn": [
          "Open"
        ],
        "hasInteraction": true
      },
      "sort": [
        {
          "field": "Name",
          "order": "Asc"
        }
      ]
    },
    {
      "viewId": "Default_Recent",
      "name": "Recent",
      "visibility": "Public",
      "icon": ":clock1:",
      "isDefault": true,
      "ownerId": "#global",
      "columns": [
        {
          "type": "Default",
          "columnId": "Name",
          "isHidden": false
        },
        {
          "type": "Default",
          "columnId": "Domain",
          "isHidden": false
        },
        {
          "type": "Default",
          "columnId": "LastInteraction",
          "isHidden": false
        }
      ],
      "filters": {},
      "sort": [
        {
          "field": "LastInteraction",
          "order": "Desc"
        }
      ]
    },
    {
      "viewId": "Qz2Kw7Fn3Bd9Mx5Lt1Gh4",
      "name": "Won customers",
      "visibility": "Private",
      "isDefault": false,
      "ownerId": "Xk2Rd7Mv4Bn9Ts1Lq6Wf3",
      "columns": [
        {
          "type": "Default",
          "columnId": "Name",
          "isHidden": false
        },
        {
          "type": "Default",
          "columnId": "Contacts",
          "isHidden": false
        }
      ],
      "filters": {
        "dealStatusIn": [
          "Won"
        ]
      },
      "sort": [
        {
          "field": "DealCreatedAt",
          "order": "Desc"
        }
      ]
    }
  ]
}

API documentation

Recording

Deal

Company

Contact

Folder

Admin automation

Workspace

User

Invite

User group

Webhook

List pinned company views

Authorizations

Query Parameters

Response