Step 1
Create a key for the integration.
- 01
Open API keys
Sign in as an owner or administrator, then open Settings → API keys.
- 02
Generate a dedicated key
Name it after the sending system and select the leads:create scope.
- 03
Store the secret
Copy the key immediately. PeopleTide shows the secret only once.
Step 2
Create a lead.
POST /public/leads
curl --request POST \
--url https://api.crm.peopletide.com/api/v1/public/leads \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"title": "Website consultation request from Asha Rao",
"email": "asha@example.com",
"phone": "+919876543210",
"source": "website",
"notes": "Asked for a weekday callback"
}'Step 3
Check the response and the workspace.
A successful request returns HTTP 201 with the lead ID. When PeopleTide finds an existing active lead with matching contact details, isConsolidated is true and the new information is added to that record.
201 response
{
"success": true,
"leadId": "lead_123",
"isConsolidated": false,
"message": "Lead created successfully"
}