Skip to main content
POST
/
v1
/
platform
/
leads
Create lead
curl --request POST \
  --url https://api.truthlocks.com/v1/platform/leads \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "email": "<string>",
  "name": "<string>",
  "company": "<string>",
  "message": "<string>",
  "source": "<string>"
}
'
{
  "id": "<string>",
  "status": "<string>"
}
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

Authorizations

​
X-API-Key
string
header
required

API key for machine-to-machine authentication

Body

application/json
​
email
string
required
​
name
string
required
​
company
string
​
message
string
​
source
string

Response

Lead captured

​
id
string
​
status
string