Search contacts

Contacts by name, email or company, with phone numbers and addresses.

GET https://cotlet.dev/api/v1/nextcloud/contacts/search

read

Searches your address books and returns matching contacts with name, company, emails and phone numbers. Use it before add_contact to avoid duplicates. An empty query lists the first contacts of the address book.

Parameters

Parameters: search_contacts
NameTypeDescription
query string string Part of a name, email or company.
address_book string string Address book name. Default: 'contacts'.
limit integer integer Maximum results. Default: 50.

Request

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

Example response

JSON

{
  "contacts": [
    {
      "contact_id": "c7f2e1a0-3b44-4d6e-8a19-2f5d9c0b7e31",
      "name": "Maria Silva",
      "company": "Brightly",
      "emails": [
        "maria@brightly.example"
      ],
      "phones": [
        "+351 21 000 0000"
      ],
      "address_book": "contacts"
    }
  ]
}

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.