Search Contacts (Zoho CRM)
Zoho CRM → Search Contacts (Zoho CRM)
/v1/zoho-search-contacts{ "email": "[email protected]", "mobile_number": "sample-value", "word": "sample-value", "criteria": "sample-value", "limit": 1 }
{ "ok": true, "data": { "contact_id": "rec_4f3a91", "first_name": "sample", "last_name": "sample", "full_name": "sample", "email": "[email protected]", "secondary_email": "[email protected]", "mobile_number": "sample", "home_mobile_number": "sample", "other_mobile_number": "sample", "fax": "sample", "title": "sample", "department": "sample", "account_id": 1, "account_name": 1, "lead_source": "sample", "date_of_birth": "sample", "salutation": "sample", "assistant": "sample", "asst_mobile_number": "sample", "category": "sample", "description": "sample", "email_opt_out": "[email protected]", "skype_id": "rec_4f3a91", "twitter": "sample", "reporting_to": "sample", "vendor_name": "sample", "mailing_address": "sample", "mailing_street": "sample", "mailing_city": "sample", "mailing_state": "sample", "mailing_zip": "sample", "mailing_country": 1, "mailing_flat": "sample", "mailing_coordinate": "sample", "mailing_latitude": "sample", "mailing_longitude": "sample", "other_address": "sample", "other_street": "sample", "other_city": "sample", "other_state": "sample", "other_zip": "sample", "other_country": 1, "other_flat": "sample", "other_coordinate": "sample", "other_latitude": "sample", "other_longitude": "sample", "is_duplicate_flag": "sample", "is_locked": "sample", "record_status": "valid", "record_image": "sample", "unsubscribed_mode": "sample", "unsubscribed_time": "sample", "nearby_distance": "sample", "owner_id": "rec_4f3a91", "owner_name": "sample", "owner_email": "[email protected]", "created_by_id": "rec_4f3a91", "created_by_name": "sample", "created_by_email": "[email protected]", "modified_by_id": "rec_4f3a91", "modified_by_name": "sample", "modified_by_email": "[email protected]", "created_time": "sample", "modified_time": "sample", "last_activity_time": "sample" } }
Search for contact records using an email, phone number, a generic word, or specific criteria.
Install
Add search contacts (zoho crm) to your MCP client.
Drop this into claude_desktop_config.json (or your client's equivalent) and the tool shows up in any chat.
{ "mcpServers": { "texau": { "command": "npx", "args": ["-y", "@texau/mcp-server"], "env": { "TEXAU_API_KEY": "..." } } } }
Tool name: texau__zoho-search-contacts
When to use this.
The "Search Contacts (Zoho CRM)" action enables users to efficiently locate contact records within Zoho CRM by utilizing various search criteria such as email addresses, phone numbers, or specific keywords. Key input parameters include optional fields like "email" for direct email searches, "mobile_number" for phone-based queries, and "word" for searching indexed text fields. Users can also apply logical operators through the "criteria" parameter to refine their searches, with a limit on the number of results returned. The action outputs a comprehensive set of contact data, including fields like contact_id, first_name, last_name, email, and various address details, ensuring users receive detailed information about each contact. This functionality is particularly useful for sales teams, marketers, and customer support representatives looking to streamline their contact management processes within the CRM category.
Try it
Run a sample request.
The response is a deterministic, cached example. No live call, no credits used.
Search Contacts (Zoho CRM)
Response
Output schema.
Every field returned in `data`. Click rows to expand nested objects.
contact_idContact Idnullabletextfirst_nameFirst Nametextlast_nameLast Nametextfull_nameFull NamenullabletextemailEmailtextsecondary_emailSecondary Emailnullabletextmobile_numberMobile Numbertexthome_mobile_numberHome Mobile Numbernullabletextother_mobile_numberOther Mobile NumbernullabletextfaxFaxnullabletexttitleTitlenullabletextdepartmentDepartmentnullabletextaccount_idAccount Idtextaccount_nameAccount Nametextlead_sourceLead Sourcenullabletextdate_of_birthDate Of BirthnullabletextsalutationSalutationnullabletextassistantAssistantnullabletextasst_mobile_numberAsst Mobile NumbernullabletextcategoryCategorynullabletextdescriptionDescriptionnullabletextemail_opt_outEmail Opt Outnullabletextskype_idSkype IdnullabletexttwitterTwitternullabletextreporting_toReporting Tonullabletextvendor_nameVendor Namenullabletextmailing_addressMailing Addressnullabletextmailing_streetMailing Streetnullabletextmailing_cityMailing Citynullabletextmailing_stateMailing Statenullabletextmailing_zipMailing Zipnullabletextmailing_countryMailing Countrynullabletextmailing_flatMailing Flatnullabletextmailing_coordinateMailing Coordinatenullabletextmailing_latitudeMailing Latitudenullabletextmailing_longitudeMailing Longitudenullabletextother_addressOther Addressnullabletextother_streetOther Streetnullabletextother_cityOther Citynullabletextother_stateOther Statenullabletextother_zipOther Zipnullabletextother_countryOther Countrynullabletextother_flatOther Flatnullabletextother_coordinateOther Coordinatenullabletextother_latitudeOther Latitudenullabletextother_longitudeOther Longitudenullabletextis_duplicate_flagIs Duplicate Flagnullabletextis_lockedIs Lockednullabletextrecord_statusRecord Statusnullabletextrecord_imageRecord Imagenullabletextunsubscribed_modeUnsubscribed Modenullabletextunsubscribed_timeUnsubscribed Timenullabletextnearby_distanceNearby Distancenullabletextowner_idOwner Idnullabletextowner_nameOwner Namenullabletextowner_emailOwner Emailnullabletextcreated_by_idCreated By Idnullabletextcreated_by_nameCreated By Namenullabletextcreated_by_emailCreated By Emailnullabletextmodified_by_idModified By Idnullabletextmodified_by_nameModified By Namenullabletextmodified_by_emailModified By Emailnullabletextcreated_timeCreated Timenullabletextmodified_timeModified Timenullabletextlast_activity_timeLast Activity Timenullabletext
Integrate
Copy-pasteable snippets.
Real endpoint: https://v3-api.texau.com/api/v1/zoho-search-contacts. Auth: x-api-key.
/v1/zoho-search-contactscurl -X POST 'https://v3-api.texau.com/api/v1/zoho-search-contacts' \ -H 'x-api-key: $TEXAU_API_KEY' \ -H 'content-type: application/json' \ -d '{"email":"[email protected]","mobile_number":"sample-value","word":"sample-value","criteria":"sample-value","limit":1}'
{ "ok": true, "data": { "contact_id": "rec_4f3a91", "first_name": "sample", "last_name": "sample", "full_name": "sample", "email": "[email protected]", "secondary_email": "[email protected]", "mobile_number": "sample", "home_mobile_number": "sample", "other_mobile_number": "sample", "fax": "sample", "title": "sample", "department": "sample", "account_id": 1, "account_name": 1, "lead_source": "sample", "date_of_birth": "sample", "salutation": "sample", "assistant": "sample", "asst_mobile_number": "sample", "category": "sample", "description": "sample", "email_opt_out": "[email protected]", "skype_id": "rec_4f3a91", "twitter": "sample", "reporting_to": "sample", "vendor_name": "sample", "mailing_address": "sample", "mailing_street": "sample", "mailing_city": "sample", "mailing_state": "sample", "mailing_zip": "sample", "mailing_country": 1, "mailing_flat": "sample", "mailing_coordinate": "sample", "mailing_latitude": "sample", "mailing_longitude": "sample", "other_address": "sample", "other_street": "sample", "other_city": "sample", "other_state": "sample", "other_zip": "sample", "other_country": 1, "other_flat": "sample", "other_coordinate": "sample", "other_latitude": "sample", "other_longitude": "sample", "is_duplicate_flag": "sample", "is_locked": "sample", "record_status": "valid", "record_image": "sample", "unsubscribed_mode": "sample", "unsubscribed_time": "sample", "nearby_distance": "sample", "owner_id": "rec_4f3a91", "owner_name": "sample", "owner_email": "[email protected]", "created_by_id": "rec_4f3a91", "created_by_name": "sample", "created_by_email": "[email protected]", "modified_by_id": "rec_4f3a91", "modified_by_name": "sample", "modified_by_email": "[email protected]", "created_time": "sample", "modified_time": "sample", "last_activity_time": "sample" } }
Compose
How this fits a workflow.
The next 2 actions most operators chain after this one.
crm
Get Account by ID (Zoho CRM)
Retrieve details of a specific account using its unique Zoho Record ID.
Delete Account (Zoho CRM)
Delete an existing account record in Zoho CRM using its unique record ID. This action typically moves the record to the Recycle Bin.
List Contacts (Zoho CRM)
Retrieve a paginated list of contacts from Zoho CRM, including basic contact fields and pagination info.
Output
Results land in a TexAu table.
Sample rows below.
Real result preview coming soon.
| Input | Status | Score |
|---|---|---|
| [email protected] | valid | 96 |
| [email protected] | risky | 54 |
| [email protected] | invalid | 12 |
Workflow
A real example.
Trigger → search contacts (zoho crm) → enrich → push to your CRM. ~80 ms operator effort, the rest runs in the background.
Built for
Who runs this.
Reliability
Rate limits & reliability.
- Per-minute limitNo public cap
- Per-day limitPlan-defined
- RetriesAutomatic w/ backoff
- ModeSync
Errors
HTTP status codes.
What each response means and what to do about it.
| Code | Cause | Fix |
|---|---|---|
| 200 OK | Action ran. Data in `data`. | Read response. |
| 400 Bad Request | Missing or malformed input. | Validate against the input schema. |
| 401 Unauthorized | Missing or invalid `x-api-key`. | Re-issue from /api-platform. |
| 403 Forbidden | Workspace lacks plan tier. | Upgrade or contact sales. |
| 404 Not Found | Action key not recognized. | Verify the slug. |
| 429 Rate Limited | Per-minute or per-day cap hit. | Backoff; reduce concurrency. |
| 500 Server Error | Unexpected TexAu issue. | Retry with backoff. |
| 502 Bad Gateway | Upstream provider 5xx. | Retry; we surface root cause. |
| 504 Timeout | Upstream slower than maxLatency. | Switch to `isAsync` polling. |
Related
More Zoho CRM actions.
Get Account by ID (Zoho CRM)
Retrieve details of a specific account using its unique Zoho Record ID.
Delete Account (Zoho CRM)
Delete an existing account record in Zoho CRM using its unique record ID. This action typically moves the record to the Recycle Bin.
List Contacts (Zoho CRM)
Retrieve a paginated list of contacts from Zoho CRM, including basic contact fields and pagination info.
Create Account (Zoho CRM)
Create a new account record in Zoho CRM, including company details, billing, and shipping addresses. Requires an Account Name.
FAQ.
Is this real-time?
Yes. Synchronous actions return in ~1–4 s. Long-running work uses async polling (see status 504 → switch to async).
Do I get charged on failure?
No. Verified failures cost zero credits. Provider miss / 5xx / timeout cascade to the next provider in the waterfall when applicable.
Does it work with Claude / Cursor via MCP?
Yes. Add the texau MCP server to your client config, then call `texau__zoho crm-...` directly.
What CRMs can I push results to?
HubSpot, Salesforce, Pipedrive, Zoho, and GoHighLevel are bidirectional. Smartlead, Instantly, Lemlist, HeyReach, Apollo Sequences, and Reply.io for outbound.
Run Search Contacts (Zoho CRM) in 60 seconds.
Pull your API key, paste the cURL, ship to your CRM.