Find a customer
harbor_find_customerSearch customers by company name, contact name, email, or exact ID. Returns customer details (ID, status, country) to resolve account references before further queries.
Instructions
Search customers by company name, contact name, email or id.
Use this to turn a human's phrasing ("the Kestrel account") into a customer id before calling harbor_customer_360.
Args:
query (string): partial name, partial email, or exact id
limit (number): 1-50, default 10
Returns JSON: { "matches": [ { "id": string, "company_name": string, "contact_name": string, "email": string, "country": string, "status": "active" | "churned", "signed_up_at": string } ], "count": number }
Emails are partially masked. Matching still works on the unmasked value, so searching "priya" finds her even though the response shows "pr***@...".
Returns an empty match list, not an error, when nothing matches.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum matches to return. | |
| query | Yes | Partial company name, contact name, email, or an exact customer id like cus_0042. |