Sign in

v1

latestOpenAPI 3.0.02026-07-26254134307.1 KB
Contact Lists

List contacts in contact list

List the contacts belonging to the requested contact list.

Required scope: contacts:read

get/contact_lists/{contact_list_id}/contacts

Path parameters

contact_list_idstring required

The contact list ID

Query parameters

page_tokenstring
Example:https://yourCompany.api.frontapp.com/endpoint?limit=25&page_token=92f32bcd7625333caf4e0f8fc26d920c812f

Token to use to request the next page

limitinteger
Example:25

Max number of results per page

Response

Array of contacts

Example response

{
  "_pagination": {
    "next": "https://yourCompany.api.frontapp.com/contacts?page_token=e0b5767cb0f1100743d46f67fcd765caac2ed"
  },
  "_links": {
    "self": "https://yourCompany.api.frontapp.com/contacts"
  },
  "_results": [
    {
      "_links": {
        "self": "https://yourCompany.api.frontapp.com/contacts/crd_3cgz4ge\"",
        "related": {
          "notes": "https://yourCompany.api.frontapp.com/contacts/crd_3cgz4ge/notes",
          "conversations": "https://yourCompany.api.frontapp.com/contacts/crd_3cgz4ge/conversations"
        }
      },
      "id": "crd_3cgz4ge",
      "name": "Dwight Schrute",
      "description": "Assistant to the regional manager",
      "avatar_url": "https://yourCompany.api.frontapp.com/contacts/crd_3cgz4ge/avatar-1673436467707",
      "groups": [
        {
          "_links": {
            "self": "https://yourCompany.api.frontapp.com/contact_lists/grp_3j342",
            "related": {
              "contacts": "https://yourCompany.api.frontapp.com/contact_lists/grp_3j342/contacts",
              "owner": "https://yourCompany.api.frontapp.com/teammates/tea_e35u"
            }
          },
          "id": "grp_3j342",
          "name": "Party Planning Committee"
        }
      ],
      "lists": [
        {
          "_links": {
            "self": "https://yourCompany.api.frontapp.com/contact_lists/grp_3j342",
            "related": {
              "contacts": "https://yourCompany.api.frontapp.com/contact_lists/grp_3j342/contacts",
              "owner": "https://yourCompany.api.frontapp.com/teammates/tea_e35u"
            }
          },
          "id": "grp_3j342",
          "name": "Party Planning Committee"
        }
      ],
      "handles": [
        {
          "handle": "dwight@limitlesspaper.com",
          "source": "email"
        }
      ],
      "custom_fields": {
        "city": "London, UK",
        "isVIP": true,
        "renewal_date": 1525417200,
        "sla_time": 90,
        "owner": "leela@planet-express.com",
        "replyTo": "inb_55c8c149",
        "Job Title": "firefighter"
      },
      "is_private": true
    }
  ]
}