List contacts

Contacts with email, tags and contact properties.

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

read

Lists the contacts of your account with name, email, country, tags and the contact properties you created in Settings > Fields. Filter by email for one contact, or by tag. Pages hold up to 100 contacts; pass next_cursor back as cursor for the next page.

Parameters

Parameters: list_contacts
NameTypeDescription
email string string Only the contact with this email.
tag string string Only contacts with this tag.
limit integer integer 1 to 100. Default: 50.
cursor string string Next page cursor from the previous call.

Request

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

Example response

JSON

{
  "contacts": [
    {
      "contact_id": "c4d9e1a2-77b0-4e0f-9a31-5b2c8e6f0d13",
      "name": "Mark Dole",
      "email": "mark.dole@example.com",
      "country": "US",
      "tags": [],
      "properties": {
        "plan": "trial"
      }
    }
  ],
  "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.