List contacts

Contacts from a Freshsales view such as Never Contacted.

GET https://cotlet.dev/api/v1/freshsales/contacts

read

Lists contacts as the Contacts module shows them for that view, with name, email, account, owner and the date they were last contacted. last_contacted is empty for a contact nobody has talked to. Read a page at a time with next_cursor.

Parameters

Parameters: list_contacts
NameTypeDescription
view string string My Contacts, All Contacts, Recently Modified or Never Contacted. Default My Contacts.
sort string string created_at, updated_at or last_contacted.
sort_type string string asc or desc. Default desc.
cursor string string next_cursor of the previous page.

Request

cURL
curl https://cotlet.dev/api/v1/freshsales/contacts \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("freshsales", "list_contacts")
Node.js
const result = await cotlet.call('freshsales', 'list_contacts');
CLI
cotlet call freshsales list_contacts

Example response

JSON

{
  "contacts": [
    {
      "contact_id": 5100231,
      "name": "Priya Nair",
      "email": "priya@harbordental.example",
      "account": "Harbor Dental",
      "owner": "Dana Reyes",
      "last_contacted": "2026-10-02"
    },
    {
      "contact_id": 5100244,
      "name": "Tomas Weber",
      "email": "tomas@northwind.example",
      "account": "Northwind Studio",
      "owner": "Dana Reyes",
      "last_contacted": null
    }
  ],
  "next_cursor": null
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.