> ## Documentation Index
> Fetch the complete documentation index at: https://leadping.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# SDKs

> Install generated Leadping SDKs for TypeScript, Python, .NET, Go, PHP, and Java, with authentication setup and API reference links.

Leadping publishes generated SDKs for teams that want typed API clients instead of hand-built HTTP calls. The SDKs are generated from the Leadping OpenAPI document with Microsoft Kiota and use the same API surface as the [API Reference](/docs/api-reference).

Use an SDK when your application needs authenticated Leadping API access for records, users, sources, conversations, analytics, phone numbers, SMS, calls, or other account workflows.

For external systems that only need to submit new leads from an approved source, the simpler path is usually direct source-key intake through [`POST /leads`](/docs/sending-leads-to-leadping) or [`POST /leads/intake`](/docs/sending-leads-to-leadping).

## Choose the right integration path

| Need                                                       | Recommended path                                    |
| ---------------------------------------------------------- | --------------------------------------------------- |
| Submit leads from a form, partner, CRM, or posting system  | Direct source-key lead intake                       |
| Build an internal app around Leadping account data         | SDK or direct API with a business API key           |
| Act as a signed-in user                                    | SDK or direct API with a Leadping user bearer token |
| Explore schemas, endpoint names, and response shapes       | [API Reference](/docs/api-reference)                     |
| Ask an AI assistant to help with docs-aware implementation | [MCP Server](/docs/mcp-server)                           |

## Packages

| Language   | Package                             | Install                                           | Registry                                                       | Repository                                                                          |
| ---------- | ----------------------------------- | ------------------------------------------------- | -------------------------------------------------------------- | ----------------------------------------------------------------------------------- |
| TypeScript | `@leadping/sdk`                     | `npm install @leadping/sdk`                       | [npm](https://www.npmjs.com/package/@leadping/sdk)             | [leadpingai/leadping-typescript](https://github.com/leadpingai/leadping-typescript) |
| Python     | `leadping`                          | `pip install leadping`                            | [PyPI](https://pypi.org/project/leadping/)                     | [leadpingai/leadping-python](https://github.com/leadpingai/leadping-python)         |
| .NET       | `Leadping.OpenApiClient`            | `dotnet add package Leadping.OpenApiClient`       | [NuGet](https://www.nuget.org/packages/Leadping.OpenApiClient) | [leadpingai/leadping-dotnet](https://github.com/leadpingai/leadping-dotnet)         |
| Go         | `github.com/leadpingai/leadping-go` | `go get github.com/leadpingai/leadping-go`        | [Go module](https://github.com/leadpingai/leadping-go)         | [leadpingai/leadping-go](https://github.com/leadpingai/leadping-go)                 |
| PHP        | `leadpingai/sdk`                    | `composer require leadpingai/sdk`                 | Composer package                                               | [leadpingai/leadping-php](https://github.com/leadpingai/leadping-php)               |
| Java       | `ai.leadping:leadping`              | `implementation "ai.leadping:leadping:<version>"` | Maven Central                                                  | [leadpingai/leadping-java](https://github.com/leadpingai/leadping-java)             |

## Authentication

Each SDK accepts a Kiota request adapter. Most SDK integrations should attach a Leadping business API key. See [API Authentication](/docs/api-authentication) for the full credential guidance.

| Header                                               | Use                                                                      |
| ---------------------------------------------------- | ------------------------------------------------------------------------ |
| `Authorization: Bearer <leadping_user_access_token>` | User-scoped API access                                                   |
| `Authorization: Bearer lp_...`                       | Business API key integrations, agents, and services                      |
| `Authorization: Bearer lp_src_...`                   | Lead ingestion endpoints only; usually direct HTTP rather than SDK usage |

The generated clients set `https://api.leadping.ai` as the base URL when the adapter does not already have one.

The SDKs do not own token storage, API key storage, refresh flows, or secret rotation. Keep credentials in your application infrastructure and inject them into the Kiota request adapter. Use `lp_src_...` only when intentionally calling lead ingestion endpoints; it is not the normal SDK credential.

## Client entry points

| Language   | Entry point                                         |
| ---------- | --------------------------------------------------- |
| TypeScript | `createLeadpingOpenApiClient(requestAdapter)`       |
| Python     | `LeadpingOpenApiClient(request_adapter)`            |
| .NET       | `new LeadpingOpenApiClient(requestAdapter)`         |
| Go         | `leadping.NewLeadpingOpenApiClient(requestAdapter)` |
| PHP        | `new LeadpingOpenApiClient($requestAdapter)`        |
| Java       | `new LeadpingOpenApiClient(requestAdapter)`         |

Use the SDK for typed route builders and model types. Use the API Reference when you need endpoint-specific request and response details.

## Versioning

SDK releases use normal `vX.Y.Z` tags. Publish workflows automatically choose the next patch version from the latest Git tag and the relevant package registry version.

## Language guides

* [TypeScript SDK](/docs/sdks/typescript)
* [Python SDK](/docs/sdks/python)
* [.NET SDK](/docs/sdks/dotnet)
* [Go SDK](/docs/sdks/go)
* [PHP SDK](/docs/sdks/php)
* [Java SDK](/docs/sdks/java)