Skip to main content
POST
/
v1
/
platform
/
leads
curl -X POST https://api.truthlocks.com/v1/platform/leads \
  -H "Authorization: Bearer <admin_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "jane@acme.com",
    "first_name": "Jane",
    "last_name": "Doe",
    "company": "Acme Corp",
    "title": "VP of Engineering",
    "industry": "finance"
  }'

{
  "id": "lead_550e8400-e29b-41d4-a716-446655440000",
  "email": "jane@acme.com",
  "first_name": "Jane",
  "last_name": "Doe",
  "company": "Acme Corp",
  "title": "VP of Engineering",
  "industry": "finance",
  "status": "new",
  "source": "api",
  "created_at": "2026-04-01T14:30:00Z",
  "updated_at": "2026-04-01T14:30:00Z"
}
Creates a new lead in the inbound leads pipeline. Use this endpoint to add leads from sources that are not connected to the website contact form, such as CRM imports, partner referrals, or internal tooling. The new lead enters the pipeline with a status of new and is immediately visible on the Leads page in the platform console.
This endpoint requires platform administrator authentication. To capture leads from a public-facing contact form without authentication, use the public lead-capture endpoint instead.

​
Parameters

​
email
string
required
Contact email address. Must be a valid email format.
​
first_name
string
required
Contact first name.
​
last_name
string
required
Contact last name.
​
company
string
Organization name associated with the lead.
​
title
string
Job title of the contact.
​
industry
string
Industry the lead’s organization operates in (for example, finance, healthcare, government).

​
Responses

{
  "id": "lead_550e8400-e29b-41d4-a716-446655440000",
  "email": "jane@acme.com",
  "first_name": "Jane",
  "last_name": "Doe",
  "company": "Acme Corp",
  "title": "VP of Engineering",
  "industry": "finance",
  "status": "new",
  "source": "api",
  "created_at": "2026-04-01T14:30:00Z",
  "updated_at": "2026-04-01T14:30:00Z"
}

curl -X POST https://api.truthlocks.com/v1/platform/leads \
  -H "Authorization: Bearer <admin_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "jane@acme.com",
    "first_name": "Jane",
    "last_name": "Doe",
    "company": "Acme Corp",
    "title": "VP of Engineering",
    "industry": "finance"
  }'