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

# Build with Leadping

> Choose the correct Leadping credential, endpoint, SDK, webhook flow, or MCP server for your integration.

Start by identifying who or what is making the request. Lead intake, user actions, organization services, webhooks, and AI tools use different trust boundaries.

## Choose the integration path

| Goal | Guide | Credential |
| - | - | - |
| Submit leads from a form, partner, or CRM | [Send Leads](https://leadping.ai/docs/sending-leads-to-leadping.md) | Source key: `lp_src_...` |
| Build a service for one organization | [API Authentication](https://leadping.ai/docs/api-authentication.md) | Organization API key: `sk_...` |
| Call the API as a signed-in user | [API Authentication](https://leadping.ai/docs/api-authentication.md) | User access token |
| Use typed models and route builders | [SDKs](https://leadping.ai/docs/sdks/overview.md) | Organization key or user token |
| Receive automation HTTP requests | [Automation Webhooks](https://leadping.ai/docs/validating-webhooks.md) | No built-in signature; review receiver limitations first |
| Connect an AI assistant | [MCP Servers](https://leadping.ai/docs/mcp-server.md) | Depends on the selected server |

> [!WARNING]
>
> A source key authorizes the external lead-ingestion routes only. It cannot read organization data or replace a user token or organization API key.

## Build the integration

1. **Select the identity.** Decide whether the caller is a source, user, organization service, or webhook recipient.
2. **Use the matching credential.** Never broaden access to avoid implementing the correct authentication flow.
3. **Choose HTTP or an SDK.** Use direct HTTP for simple integrations or a generated SDK for typed models and route builders.
4. **Handle failure explicitly.** Validate status codes, respect rate limits, and retry only when the operation is safe.
5. **Test the real path.** Exercise production authentication, payload construction, error handling, and downstream effects with controlled data.

## Prove the smallest complete integration

For an organization service, start with `GET /organizations/me` to confirm the credential’s organization. Then read a known lead with `GET /leads/{id}`. This separates authentication and access problems from payload or workflow problems.

For intake, submit one controlled lead with a source key and a real certificate. Save the returned lead ID, inspect its processing status in Leadping, and verify any configured follow-up. The [intake guide](https://leadping.ai/docs/sending-leads-to-leadping.md) includes the request and reconciliation procedure.

Before adding writes, document which calls create billable work, start an automation, change an owner, or remove access. A successful HTTP request confirms only that operation’s result; it does not confirm every downstream action.

## Keep a useful integration log

Record the operation, timestamp with time zone, HTTP status, returned record ID, and a local job ID. Capture `Retry-After` and a request or trace ID when present. Keep payloads, credentials, certificate URLs, and message content out of routine logs.

On failure, distinguish requests that were rejected from requests whose outcome is unknown. That distinction determines whether to correct the input, wait, reconcile, or escalate.

## Production baseline

* Use HTTPS for every request.
* Store credentials in protected runtime configuration or a secret manager.
* Keep credentials and sensitive payloads out of logs and URLs.
* Grant only the access the integration needs.
* Rotate exposed or unused credentials.
* Review the automation action’s [authentication limitations](https://leadping.ai/docs/validating-webhooks.md#secure-the-receiver) before accepting requests at a receiver.
* Keep a submission ledger and reconcile uncertain writes before repeating them; do not assume every endpoint supports idempotency.
* Treat lead, contact, and conversation data as sensitive.

## SDKs

> [card] [TypeScript](https://leadping.ai/docs/sdks/typescript.md)

> [card] [Python](https://leadping.ai/docs/sdks/python.md)

> [card] [.NET](https://leadping.ai/docs/sdks/dotnet.md)

> [card] [Go](https://leadping.ai/docs/sdks/go.md)

> [card] [PHP](https://leadping.ai/docs/sdks/php.md)

> [card] [Java](https://leadping.ai/docs/sdks/java.md)

Use the [API Reference](https://leadping.ai/docs/api-reference.md) for endpoint contracts and the [OpenAPI specification](https://leadping.ai/docs/openapi.json) for code generation or schema tooling.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.