--- title: Kaspr API Integration on Truto slug: kaspr category: Sales Intelligence canonical: "https://truto.one/integrations/detail/kaspr/" --- # Kaspr API Integration on Truto **Category:** Sales Intelligence **Status:** Beta ## MCP-ready AI tools Truto exposes 4 tools for Kaspr that AI agents can call directly. - **list_all_kaspr_credits** — Get the remaining credits in the Kaspr workspace. A workEmailCredits value of -1 means unlimited. Returns: workEmailCredits, directEmailCredits, phoneCredits, exportCredits. - **kaspr_linkedin_profiles_enrich** — Retrieve a prospect's work email, direct (personal) email and phone number from Kaspr using their LinkedIn profile. Returns the enriched profile: id, name, professionalEmails, personalEmails, phones, title, company, fetchedAt, processingTime. Requested data types consume credits, plus one export credit per successful call. Required: id, name. - **list_all_kaspr_me** — Verify that the connected Kaspr API key is valid. Returns: user (identifies the key owner; Kaspr shows an email address here). - **list_all_kaspr_rate_limits** — Get the request rate limits configured for the Kaspr workspace. Returns: dailyLimit, hourlyLimit, minutelyLimit. ## How it works 1. **Link your customer's Kaspr 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 Kaspr.** The Proxy API is a 1-to-1 mapping of the Kaspr 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 - **Enable native LinkedIn-to-contact enrichment inside your CRM or sales tool** — Let your users paste a LinkedIn profile and instantly get verified mobile numbers and emails appended to the lead record, without leaving your product. Kaspr's European mobile coverage makes this especially valuable for SaaS tools serving EMEA sales teams. - **Power a data waterfall for prospecting platforms** — If your platform already offers lead data, add Kaspr as a fallback provider when primary sources miss mobile numbers or personal emails. Users get higher match rates without having to run a separate enrichment tool. - **Offer one-click contact reveal in dialers and ATSs** — Embed a 'Reveal with Kaspr' action on candidate or prospect profiles so recruiters and SDRs can pull a direct phone number and dial immediately. This keeps users in your workflow instead of toggling to the Kaspr web extension. - **Trigger buyer-committee enrichment for ABM and intent platforms** — When your platform detects account-level intent signals, enrich the LinkedIn profiles of the buying committee via Kaspr so your users see mobile numbers of decision-makers the moment intent fires. This turns anonymous intent data into actionable outbound in seconds. - **Build credit-aware bulk enrichment for CSV uploads** — Allow users to upload lists of LinkedIn profiles and run enrichment in the background, with your system checking Kaspr credit balances and rate limits before executing. Users avoid failed jobs and get transparent reporting on what their credits actually covered. ## What you can build - **LinkedIn profile enrichment action** — Pass a LinkedIn ID and name through Kaspr to populate professional emails, personal emails, phone numbers, title, and company on any record in your product. - **Credit-aware enrichment router** — Query the Kaspr credits endpoint before each run and dynamically request only the data types (phones, work email, direct email) the user still has credits for. - **Rate-limit-aware background workers** — Read Kaspr's daily, hourly, and minutely limits at job start and throttle your enrichment queue so large batch jobs complete without 429 errors. - **Connection health and 'Connected as' UI** — Use the Kaspr me endpoint on connection setup to validate the API key, display the connected user's email in your settings page, and surface auth failures proactively. - **Credit balance dashboard for end users** — Expose each user's remaining work email, direct email, phone, and export credits inside your app so they understand usage before kicking off bulk operations. - **Conditional sequence branching on enrichment results** — Route prospects down different sequence paths based on what Kaspr returns — personal email found goes to an email step, phone found goes to an SMS or dial step. ## FAQs ### How do end users authenticate their Kaspr account? Kaspr uses API key authentication. Your users paste their Kaspr API key into your UI, and Truto stores and injects it on every call. You can validate the key immediately by calling the me endpoint, which returns the connected user's email. ### What data can I pull from a Kaspr enrichment call? The LinkedIn profile enrich endpoint returns professional emails, personal emails, phone numbers, title, and company for a given LinkedIn ID and name. Each successful call consumes an export credit plus the specific data-type credits requested. ### How do I handle Kaspr's rate limits in a bulk workflow? Kaspr exposes daily, hourly, and minutely request limits via a dedicated rate limits endpoint. Before starting a batch job, query this endpoint and throttle your background workers accordingly to avoid 429 errors on long-running enrichments. ### How does credit management work across different data types? Kaspr tracks separate balances for work email credits, direct email credits, phone credits, and export credits (where -1 means unlimited). Call the credits endpoint before enrichment runs so you can skip data types a user is out of and avoid credit-rejection errors. ### Does Truto normalize Kaspr data into a unified sales intelligence schema? Not currently — there is no unified sales intelligence API for Kaspr yet. You work directly with Kaspr's native response shape through Truto's connector, which still handles auth, request proxying, and error normalization for you. ### Can I request additional Kaspr endpoints that aren't listed? Yes. Truto's connectors are extensible, so if you need Kaspr capabilities beyond the current enrich, credits, me, and rate limits tools, you can request additional endpoints and have them added to the integration.