Search contacts

POST

/users/me/contacts/search

Full-text, typo-tolerant search across name, phone, company, and tags. Results are ranked by similarity then recency. If the query contains digits, also matches against the normalized (digits-only, last 10) phone so 555-123 and (555) 123 find the same contact. With injectCalls=true, recent matching calls are returned as synthetic contacts (source WEB, max 5) — useful for surfacing numbers that aren't saved yet.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Query Params

Responses

🟢200

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/users/me/contacts/search?query=&limit=&offset=&injectCalls=' \
--header 'Authorization: Bearer <token>'

Response Example

{
    "contacts": [
        {
            "firstName": "string",
            "lastName": "string",
            "phoneNumber": "string",
            "email": "string",
            "address": "string",
            "notes": "string",
            "companyName": "string",
            "tags": [
                "string"
            ],
            "avatar": "string",
            "isFavorite": true,
            "source": "MOBILE",
            "lifecycleStage": "lead",
            "doNotCall": true,
            "doNotSms": true,
            "id": "string",
            "stats": {
                "totalIncomingCalls": 0,
                "totalOutboundCalls": 0,
                "totalSmsMessages": 0,
                "lastCallDate": "string",
                "upcomingAppointments": 0
            },
            "latestNote": {
                "content": "string",
                "createdAt": "string"
            },
            "suggestedLifecycleStage": "string"
        }
    ],
    "pagination": {
        "total": 0,
        "limit": 0,
        "offset": 0
    },
    "aggregations": {
        "uniqueCompanies": 0,
        "companies": [
            "string"
        ]
    }
}

Modified at 2026-07-23 18:02:16

Merge two duplicate contacts

Import contacts from CSV or JSON file