LeadTruffle API guide
Connect LeadTruffle to ChatGPT or Claude
Give a tool-enabled AI agent access to your LeadTruffle leads, conversations, qualification data, and AI call details through the LeadTruffle API.
Quick Answer
tl;dr: Generate an API key in your LeadTruffle dashboard, then give a code or tool-enabled ChatGPT or Claude session the key and our API docs. Ask it to pull data from the leads endpoint and analyze your conversations, lead quality, sources, and AI call transcripts.
Three steps
How to connect LeadTruffle to ChatGPT or Claude
-
Generate an API key
Open API Keys in your LeadTruffle dashboard and generate a key for your AI session. Treat it like a password.
-
Give the agent our API docs
Open Claude on your desktop, Claude Code, or a ChatGPT workspace that can make API requests. Point it to the LeadTruffle API documentation and supply the key in a private session.
-
Ask it to pull and analyze your leads
Start with the leads endpoint. The agent can follow pagination, retrieve individual lead records, and analyze the full data returned for your account.
Copy and paste
A starter prompt for ChatGPT or Claude
Copy this prompt, then provide your API key separately when you start the private session. You can then ask follow-up questions about any date range or part of your lead data.
GET requests only. Your API key can access
other documented actions, so require approval before any request that changes data.
Use the LeadTruffle API documentation here:
https://api-docs.leadtruffle.com/#description/introduction
Use my API key securely in the X-API-Key header. Start with this endpoint:
GET https://pub-api.leadtruffle.com/api/v1/pub/leads
Use GET requests only. Follow pagination until you have the date range I request. Then analyze my lead sources, qualification results, message history, follow-up opportunities, and AI-handled call details. For calls, use the full transcript, summary, duration, and recording information when available.
Before making any request that would change data, stop and ask for my approval. What you can analyze
Turn your LeadTruffle data into answers
The agent can combine lead records, conversation history, and call data to answer practical questions about your account.
Lead quality
Compare qualification results, customer needs, and booking readiness.
Source performance
Review which lead sources produce the strongest conversations and outcomes.
Call patterns
Analyze full transcripts, summaries, duration, and call outcomes when available.
Follow-up opportunities
Find unanswered questions, stalled conversations, and leads that need attention.
FAQ
LeadTruffle, ChatGPT, and Claude questions
Can ChatGPT or Claude connect to LeadTruffle automatically?
Yes, when you use a ChatGPT or Claude session that can run code, make HTTPS requests, or use a connected API tool. Give the agent your LeadTruffle API key and API documentation, then ask it to use the leads endpoint.
Which LeadTruffle endpoint should my AI agent use?
Start with GET /v1/pub/leads. It returns up to 10 leads per request and supports cursor-based pagination. Your agent can follow the API documentation to retrieve more pages or request one lead by its ID.
Can an AI agent analyze LeadTruffle call transcripts?
Yes. AI-handled call records can include the full transcript, a transcript summary, call duration, caller details, and a recording URL when those fields are available.
How should I protect my LeadTruffle API key?
Only share the key with a trusted, private AI session. Do not post it in a public or shared chat. Ask the agent to use GET requests only unless you want it to change data, and revoke keys you no longer need.
Need another endpoint or help getting connected?
Tell us what you want your AI agent to analyze. We can help with the setup or talk through additional API access.