List contacts

Lists contacts or companies, filtered by search text, tag or owner.

GET https://cotlet.dev/api/v1/agile-crm/contacts

read

Returns one page of contacts with id, name, email, company, tags, lead score, star value and owner, plus next_cursor while more remain.

Parameters

Parameters: list_contacts
NameTypeDescription
query string string Search text matched against names, emails and companies
tag string string Only contacts with this tag, spelled as in Agile CRM
owner_email string string Only contacts owned by this user
type string string person (default) or company
cursor string string next_cursor from the previous page

Request

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

Example response

JSON

{
  "contacts": [
    {
      "contact_id": "5698320417841152",
      "name": "Dana Whitfield",
      "email": "dana@example.com",
      "company": "Northwind Studio",
      "tags": [
        "webinar_oct",
        "lead"
      ],
      "score": 40,
      "star": 3,
      "owner": "sam@example.com"
    },
    {
      "contact_id": "5701182246576128",
      "name": "Luis Ortega",
      "email": "luis@example.org",
      "company": "Ortega Print",
      "tags": [
        "webinar_oct"
      ],
      "score": 15,
      "star": 0,
      "owner": "sam@example.com"
    }
  ],
  "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.