--- title: UpLead API Integration on Truto slug: uplead category: Sales Intelligence canonical: "https://truto.one/integrations/detail/uplead/" --- # UpLead API Integration on Truto **Category:** Sales Intelligence **Status:** Beta ## MCP-ready AI tools Truto exposes 18 tools for UpLead that AI agents can call directly. - **list_all_up_lead_credits** — Get the remaining credit balance of the connected UpLead account. Returns email and credits. Unpaginated: the list returns this one object as a single record. Credit cost is not documented (UNVERIFIED). It returns no contact or company record. - **up_lead_companies_enrich** — Look up one UpLead company by domain, company name or UpLead company id; a domain gives the most precise match. Returns data (the company profile: address, size, revenue, industry, SIC and NAICS codes, description, social URLs, ticker) and userInfo.availableCredits. Costs one credit per company record received; the same record is not charged twice. - **up_lead_companies_find_domain** — Convert a company name to its website domain and logo with UpLead. The match is on the exact name and returns the most important company by website traffic, so names that are not unique can give inaccurate results. Returns data (company_name, domain, logo) and userInfo.availableCredits. Credit cost is not documented (UNVERIFIED). - **up_lead_companies_quick_search** — Search UpLead companies by text and filters (domains, industries, SIC/NAICS, size, revenue, location). Sends type=company in the body; a caller-supplied type is not blocked and overrides it. Body page/per_page (max 100); count_only gives data.count. Returns data and userInfo. Professional, Elite, and Enterprise plans only. One credit per company. - **up_lead_people_enrich** — Look up one UpLead contact by email, by first_name + last_name + domain, or by id. Returns data (name, title, job function, management level, email and email_status, phones, location, LinkedIn URL, company name, domain, industry) and userInfo. One credit per contact received (with an email: only if valid or accept_all). - **up_lead_people_enrich_with_company** — Look up an UpLead contact and their company from an email address. Returns data (the contact plus a company object with the full company profile) and userInfo. One credit per contact or company record received (contacts with an email only if valid or accept_all); whether this is one record or two is UNVERIFIED. - **up_lead_people_search** — Find UpLead contacts at one company (domain required) by job function, sub function, management level, title, location, name or email status. Page via body page/per_page (max 100); count_only returns data.count. Returns data (results, meta) and userInfo. One credit per contact received (with an email: only if valid or accept_all). - **up_lead_people_pro_search** — Search UpLead contacts by domains, job function, titles, location, industry, size and revenue. Body page/per_page (max 100); count_only gives data.count. Returns data and userInfo. Professional, Elite, and Enterprise plans only. One credit per contact (with an email: if valid or accept_all); a second for its embedded company is UNVERIFIED. - **up_lead_people_quick_search** — Search UpLead contacts. Sends type=contact in the query; a caller type overrides it. Text, filters and page/per_page (max 100) go in the query; a JSON body is ignored. Returns data, userInfo. Professional, Elite, and Enterprise plans only. One credit per contact (with an email: if valid or accept_all); a second for its company is UNVERIFIED. - **up_lead_people_preview** — Only for resellers. Preview UpLead contacts (id, name, title, company) before unlocking contact data. Use is governed by UpLead's Supplementary Terms of Use for Preview API Access (T&C s3.6.1, https://www.uplead.com/terms-and-conditions/). num_results: 1-500, default 100; count_only returns data.count. Returns data. Credit cost UNVERIFIED. - **list_all_up_lead_industries** — List UpLead industries, or only those whose name matches text. Returns id and industry_name for each industry; use the ids as industries_ids in search filters. Unpaginated: every match comes back in one response. Professional, Elite, and Enterprise plans only. Credit cost is not documented (UNVERIFIED). - **list_all_up_lead_lists** — List the saved contact lists in the UpLead account, optionally filtered by list name (text). Returns id, name and contacts_count for each list. Page with limit and next_cursor; do not pass page or per_page. Professional, Elite, and Enterprise plans only. Credit cost is not documented (UNVERIFIED). - **get_single_up_lead_list_by_id** — Get one UpLead list by id. Returns id, name and contacts_count. Professional, Elite, and Enterprise plans only. Credit cost is not documented (UNVERIFIED). - **create_a_up_lead_list** — Create an UpLead list. Returns the new list's id, name and contacts_count. Professional, Elite, and Enterprise plans only. Credit cost is not documented (UNVERIFIED). - **delete_a_up_lead_list_by_id** — Delete an UpLead list by id. Returns data (null) and userInfo.availableCredits on success. Professional, Elite, and Enterprise plans only. Credit cost is not documented (UNVERIFIED). - **list_all_up_lead_list_contacts** — List the contacts in one UpLead list (list_id), optionally filtered by contact name, company name or company URL (text). Returns id, first_name, last_name, title and company (id, name, logo_url). Page with limit and next_cursor; do not pass page or per_page. Professional, Elite, and Enterprise plans only. Credit cost not documented (UNVERIFIED). - **up_lead_list_contacts_add** — Add UpLead contacts (contact_ids) to a list (list_id). Returns the list's id, name and contacts_count. Professional, Elite, and Enterprise plans only. Credit cost is not documented (UNVERIFIED). - **up_lead_list_contacts_remove** — Remove UpLead contacts (contact_ids) from a list (list_id). Returns the list's id, name and contacts_count. Professional, Elite, and Enterprise plans only. Credit cost is not documented (UNVERIFIED). ## How it works 1. **Link your customer's UpLead account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app. 2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request. 3. **Call Truto's API to reach UpLead.** The Proxy API is a 1-to-1 mapping of the UpLead API. 4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field. ## Use cases - **Embed in-app prospecting for your users** — Let your users search UpLead's B2B database directly inside your SaaS, preview results without burning credits, and save contacts to lists — all powered by their own connected UpLead account via Truto. - **Auto-enrich inbound leads and shorten forms** — Capture just an email on your signup or demo form and use UpLead enrichment through Truto to instantly resolve full person and company profiles, enabling smarter scoring and routing without asking users for more fields. - **Power AI personalization with firmographic context** — Feed enriched job titles, industries, technographics, and company descriptions from UpLead into your LLM prompts so your outbound or sales engagement product can generate hyper-relevant messaging per prospect. - **Keep CRM and account data clean** — RevOps and CRM-hygiene tools can resolve messy company names to canonical domains, fill in missing firmographics, and standardize records on a schedule using UpLead's enrich endpoints behind a single Truto connection. - **Sync target account lists back to UpLead** — Let your users push ICP-matched accounts or contacts generated inside your product directly into their UpLead lists, so their SDRs can work the same accounts in their native UpLead workspace. ## What you can build - **Email-to-full-profile enrichment** — Resolve any raw email into a complete person + company record in a single call using UpLead's combined person/company enrich endpoint through Truto. - **Domain resolver for colloquial company names** — Translate inputs like 'IBM' or 'Amex' into verified corporate domains, then chain into company enrichment for clean, routable firmographic data. - **Credit-safe preview search** — Show masked contact previews (name, title, company) from UpLead search before users spend credits, and only trigger full unlock on explicit intent. - **ICP-based company and people search** — Build a native search UI backed by UpLead's people and company search tools, with industry pickers populated from the industries endpoint. - **Two-way UpLead list management** — Create lists, add or remove contacts, and read list membership from inside your app so target accounts stay in sync with your users' UpLead workspace. - **Credit balance guardrails** — Surface your users' remaining UpLead credits in-app and gate bulk operations against available balance to prevent runaway spend. ## FAQs ### How do end users authenticate their UpLead account? UpLead uses API key authentication. Through Truto, your users supply their UpLead API key once during connection, and Truto securely stores and injects it on every request — you never handle the key directly. ### How are UpLead credits consumed through the API? UpLead only charges credits for successful hits (valid or accept_all emails). You can use preview and count-only search modes to size results before committing credits, and check the user's live balance via the credits endpoint. ### Can we check a user's remaining credit balance before running bulk operations? Yes. Truto exposes UpLead's credits endpoint, so you can read the connected account's remaining balance and enforce your own guardrails before executing large enrichment or search jobs. ### Does UpLead return both person and company data in a single call? Yes. The people-enrich-with-company tool returns the contact's role, management level, and LinkedIn URL alongside the company's industry, revenue, and address in one request — ideal for CRM and outreach flows. ### Are UpLead lists available to every user? UpLead's list management endpoints (create list, add/remove contacts, read list contents) typically require the user to be on a Professional, Elite, or Enterprise plan. Truto will surface UpLead's error responses so you can gracefully handle users on lower tiers. ### How fresh is the data returned by UpLead? UpLead performs real-time email verification at the moment of the API call and backs it with a 95% accuracy guarantee, refunding credits for bounced emails. Firmographic and technographic data is maintained by UpLead on an ongoing basis. ### What if we need an UpLead endpoint that isn't listed yet? Truto can add additional UpLead endpoints on request. Reach out with the specific operation you need and it can typically be added to your connection without changes on your side beyond calling the new tool.