Find a person's data
Every record the account holds about one person, by email or phone, with each kind's count and ids.
Free
This tool costs nothing to call.
An example
Hannah Price asked what we store about her. What do we have?
Your agent callsaccount_find_personFree
The example business is Halverson Cycle & Repair, a bike shop with a repair workshop in Portland, Oregon. The reply is the one the tool really gives.
{
"email": "hannah.price@example.com"
}Use it when
Someone asks what the business keeps about them, or before exporting or erasing their data.
- For a word or name anywhere in files, emails and records, use
account_search. - For one CRM customer with everything open, use
crm_get_customer.
What it does
Every record this account holds about one person, by their email address or phone number, across every area: CRM, chats, emails, tickets, forms, bookings, calls, applications, invoices, orders, newsletters, HR and the call log, with their chats and CRM history. For a person who asks what the business keeps about them (GDPR Art. 15). Shows each kind with its count and ids; account_export_person gives them a copy, account_erase_person erases what may go.
What comes back
found: each kind (like crm.contact or market.formresponse) with its name, how many records and up to 20 ids; records in all; a note when nothing holds them. Every reply also carries cost_usd and balance_usd.
Inputs
| Name | Type | What it is |
|---|---|---|
email | string | The person's email address. Up to 254 characters. |
phone | string | Their phone number in international format, like +1 503 555 0145. Up to 40 characters. |
The call
Over MCP, call account_find_person on https://api.conecto.chat/mcp/account. Over REST:
curl -X POST https://api.conecto.chat/v1/tools/account_find_person \
-H "Authorization: Bearer $CONECTO_KEY" \
-H "Content-Type: application/json" \
-d '{"email":"hannah.price@example.com"}'When it refuses
A refused call costs nothing and says what to do next.
| Code | When | What to do |
|---|---|---|
invalid_input400 | Neither an email nor a phone number was given, the email is not an address, or the phone number is not in international format. | Send email, or phone like +1 503 555 0145. |
More Account tools
All 28 tools- Check balance
account_balanceThe balance, this key's daily budget, auto-reload, and how much of the month's free reads and downloads is used.Free - Refund a top-up
account_refund_topupRefunds a top-up from the last 24 hours that none of has been used: the credit, with its tax, goes back to the card, and the service fee is kept.Free - Get a sign-in link for the owner
account_owner_linkA one-time link that signs the business owner into their Conecto page, without a password.Free - Read the limits
account_get_limitsThe limits Conecto raises on request, each with its standard and current value, and the business's requests with their answers.Free - Ask for a higher limit
account_request_limitAsk Conecto to raise a limit: which one, the number the business needs, and why.Free - Read recent events
account_eventsWhat happened lately, oldest first: applications, bookings, form responses, signatures, replies, emails, website goals and the agents' own events.Free* - Send an event of your own
account_emit_eventSends an event the agent names, custom.<name>, to the channels subscribed to it and to account_events.$0.005 per channel it goes to - Search everything
account_searchOne search across the business's files, table rows, help articles, CRM, emails, tickets, invoices, books, stock and tasks.Free*
Give this to your agent.
Set up Conecto from https://conecto.chat/SKILL.md