LeadTruffle API guide

ChatGPT Claude

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.

LeadTruffle leads API
Lead and contact details
Qualification and attribution
Message history
Call transcripts and summaries

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

  1. Generate an API key

    Open API Keys in your LeadTruffle dashboard and generate a key for your AI session. Treat it like a password.

  2. 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.

  3. 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.

Keep control of your account. Tell the agent to use GET requests only. Your API key can access other documented actions, so require approval before any request that changes data.
Starter prompt
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.