Public API

LeadPanel ingestion API

Send records from your product to LeadPanel with a single project API key. The API is designed for backend jobs, product events, partner integrations, and lightweight form ingestion.

Quickstart
  1. Create a project API key in Projects -> API Keys.
  2. Choose a target DataSource ID or use the slug endpoint for flexible ingest.
  3. Send JSON payloads with the X-Api-Key header.

Authentication

Every request must include a project-scoped API key.

X-Api-Key: lp_your_project_key

Main endpoints

  • POST /api/v1/ingest/{dataSourceId}
  • POST /api/v1/ingest/{dataSourceId}/batch
  • POST /api/v1/ingest/by-slug/{slug}

Field types

  • String, Number, Boolean
  • Date in ISO-8601
  • StringList for tag-like arrays
Example request
curl -X POST "https://your-domain/api/v1/ingest/11111111-2222-3333-4444-555555555555" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: lp_your_project_key" \
  -d '{
    "values": {
      "email": "user@example.com",
      "plan": "pro",
      "score": 42
    },
    "externalId": "user-123"
  }'
When to use each endpoint
  • Single ingest: one record at a time with a fixed DataSource.
  • Batch ingest: up to 100 records in one request.
  • By slug: create or reuse a flexible DataSource without knowing its GUID.