What you can ask
“Search Clay for VP-level marketing contacts at US fintech companies.”
“What people filters does Clay support?”
“Run my enrich-and-score routine on these 40 leads.” (asks for approval first)
“Kick off a batch enrichment for the 2,000 companies in this file.” (asks for approval first)
“Query our accounts table in Clay for rows added this week.”
Connecting
- In Clay, create a key under Settings → Account → API keys.
- Open Connections in the dashboard and click Clay → Connect.
- Paste the key into the connect dialog, it’s validated against Clay and stored only in Secret Manager.
- Ask Expertise to search Clay to confirm it’s live.
Tools
Good to know
- Routine runs cost Clay credits and pause for approval. A routine can also send messages or write to your CRM, so Expertise states the routine, item count, and known effect before anything starts.
- Expertise needs the routine’s id. Clay’s API doesn’t list routines, so point Expertise at the routine or Workflow id from your Clay configuration.
- Table queries are read-only. Expertise can query eligible Clay tables but can’t create, update, or delete tables or rows. Tables API access is a Clay Enterprise feature.
- Searches page through live data. Large searches come back page by page, Expertise keeps fetching until Clay reports the search is exhausted.
- Advanced query mode is in beta. When structured filters can’t express a search, Expertise can author a query in Clay’s advanced query language instead; count-mode and jobs queries aren’t supported, and filter-mode and query-mode searches page through their own separate tools.
Troubleshooting
Clay shows connected but searches fail
Clay shows connected but searches fail
Reconnect from the Connections tile with a fresh API key, the original
key may have been revoked in Clay.
A table query returns an access error
A table query returns an access error
Clay’s Tables API is Enterprise-only, check that your Clay workspace is
on an Enterprise plan and the table id is correct.
A routine run reports failed items
A routine run reports failed items
Expertise reports failed and partial items separately from successes,
check that each item’s inputs match what the routine declares, then rerun
just the failed items.