Endpoint
Send one JSON object for each enquiry.
/api/v1/public/leadsCreate a new lead or consolidate information into an existing active lead.
- Required scope
leads:create- Request
{ title?, email?, phone?, source?, notes?, content? }- Response
201 { success, leadId, isConsolidated, message }
- email must be valid when present.
- phone accepts 5–20 characters and is normalized by PeopleTide.
- content is an optional object for source-specific fields.
Field mapping
Keep operational fields simple.
- title — a short reason the person enquired.
- email and phone — the identifiers PeopleTide can use to match the customer.
- source — a stable system or campaign label such as justdial or website.
- notes — human-readable context for the person following up.
- content — source-specific structured data that should remain attached to the lead.
Launch checklist
Verify the complete handoff.
- 01
Send a distinctive test enquiry
Use a controlled phone number and source label that your team can recognize.
- 02
Confirm the lead record
Check the title, source, notes, and structured content in PeopleTide.
- 03
Test a repeat
Resend the same contact details and confirm the response reports consolidation.
- 04
Connect follow-up
Create and test the workflow that should run after the lead or form event.
