GET
/
v1
/
groups
/
{groupId}
/
custom-fields
/
{entityType}
curl --request GET \
  --url https://api.folk.app/v1/groups/{groupId}/custom-fields/{entityType} \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "items": [
      {
        "name": "Status",
        "type": "singleSelect",
        "options": [
          {
            "label": "Active",
            "color": "#ffffff"
          },
          {
            "label": "Inactive",
            "color": "#000000"
          }
        ]
      },
      {
        "name": "Total Revenue",
        "type": "numericField",
        "config": {
          "format": "currency",
          "currency": "USD"
        }
      },
      {
        "name": "Details",
        "type": "textField"
      },
      {
        "name": "Tags",
        "type": "multipleSelect",
        "options": [
          {
            "label": "Tag 1",
            "color": "#ffffff"
          },
          {
            "label": "Tag 2",
            "color": "#000000"
          }
        ]
      },
      {
        "name": "Relationships",
        "type": "contactField"
      },
      {
        "name": "Date",
        "type": "dateField"
      },
      {
        "name": "Assigned to",
        "type": "userField"
      },
      {
        "name": "Deals",
        "type": "objectField"
      },
      {
        "name": "Magic field",
        "type": "magicField"
      }
    ],
    "pagination": {
      "nextLink": "https://api.folk.app/v1/groups/grp_bc984b3f-0386-434d-82d7-a91eb6badd71/custom-fields/person?limit=20&cursor=eyJvZmZzZXQiOjIwfQ%3D%3D"
    }
  }
}

Authorizations

​
Authorization
string
header
required

API key for authentication

Path Parameters

​
groupId
string
required

The identifier of the group. You can retrieve a list of group identifiers using the /v1/groups endpoint.

Required string length: 40
​
entityType
enum<string>
required

The entity type the custom fields belong to. It can be either person or company.

Available options:
person,
company

Query Parameters

​
limit
integer
default:20

The number of items to return.

Required range: 1 <= x <= 100
​
cursor
string

A cursor for pagination across multiple pages of results. Don’t include this parameter on the first call. Use the pagination.nextLink value returned in a previous response to request subsequent results.

Maximum length: 128

Response

200
application/json

A paginated list of group custom fields for an entity type. The data.items field contains the list of group custom fields, and the data.pagination.nextLink field contains a link to the next page of results, if available.

The response is of type object.