Connect your app to Clay
You can connect your Lovable app to Clay, a platform for sales and marketing data, to find people and companies, enrich data, and use Clay tables. This lets your app access live prospecting and enrichment data directly from Clay.
Anyone building sales, marketing, or internal go-to-market apps will need this to integrate Clay's data and routines.
Do this, in order
- 1
Sign in to your Clay account and go to 'Settings' > 'Account' > 'API keys (beta)'.
You need a Clay Public API key to allow Lovable to securely connect to your Clay workspace.
- 2
Create a new API key, give it a clear name, and copy it securely.
This key is like a password for Lovable to access Clay; keep it safe and remember it for the next step.
- 3
In Lovable, go to 'Connectors', select 'Clay', and click 'Add connection'.
This starts the process of setting up the connection between Lovable and Clay.
- 4
Give your connection a 'Display name' (e.g., 'Clay Prod') and paste the Clay Public API key you copied.
The display name helps you identify this specific connection, and the API key authenticates Lovable with Clay.
- 5
Choose who can use this connection by either keeping it private, sharing with specific workspace members, or inviting the entire workspace.
This controls who in your Lovable workspace can use this Clay connection in their projects.
- 6
Click 'Connect' to finalize the connection.
Lovable will verify your API key and save the connection, making Clay available for your projects.
Paste this into your project
I need to connect my Lovable app to Clay. I have my Clay Public API key ready. Can you guide me through setting up the connection in Lovable and then linking it to my project so I can start searching people and companies, running routines, and querying tables?
Words decoded
- Go-to-market (GTM) data platform
- A service that provides information about potential customers and companies to help businesses find and sell to them.
- Enrichment routines
- Automated processes or workflows in Clay that add more details or context to existing data, like finding a person's job title or a company's revenue.
- Firmographics
- Characteristics of a company, similar to demographics for people, such as industry, size, revenue, and location.
- Asynchronously
- When a task starts but doesn't immediately give you the result; it works in the background, and you check back later for completion, rather than waiting for it to finish right away.
- Poll for results
- Repeatedly check to see if a background task has finished and if its results are ready.
Where people get stuck
- Using a Clay legacy workspace API key instead of a Public API key from 'API keys (beta)' will prevent the connection from working.
- Forgetting that searches and routine runs consume Clay credits and count towards your Clay plan's rate limits.
- Expecting instant results from Clay routines; they run in the background, so your app needs to be designed to check for completion.
- Trying to query Clay tables without a Clay Enterprise plan, as this feature is exclusive to that plan.
- Not securing your Clay API key, as it functions like a password and should never be shared publicly.
The short version, steps, decoder and prompt on this page are written automatically from Lovable's own documentation and can lag or misread it. The official page is always the authority.